ZipArchive::addFile
ZipArchive::addFile
(PHP 5 >= 5.2.0, PHP 7, PECL zip >= 1.1.0)
ZipArchive :: addFile - 将文件从给定路径添加到 ZIP 归档文件中
描述
bool ZipArchive::addFile ( string $filename [, string $localname = NULL [, int $start = 0 [, int $length = 0 ]]] )
将文件从给定路径添加到 ZIP 归档文件中。
注意
:为了获得最大的可移植性,建议在 ZIP 文件名中始终使用正斜杠(/
)作为目录分隔符。
参数
filename
要添加的文件的路径。
localname
如果提供,这是 ZIP 档案中的本地名称,它将覆盖filename
。
start
该参数不被使用,但是需要扩展 ZipArchive 。
length
该参数不被使用,但是需要扩展 ZipArchive 。
返回值
TRUE
成功或FALSE
失败时返回。
例子
这个例子打开一个 ZIP 文件存档 test.zip 并添加文件 /path/to/index.txt 。作为 newname.txt 。
Example #1 Open and add
<?php
$zip = new ZipArchive;
if ($zip->open('test.zip') === TRUE) {
$zip->addFile('/path/to/index.txt', 'newname.txt'
$zip->close(
echo 'ok';
} else {
echo 'failed';
}
?>
注
注意
:当文件被设置为添加到存档时,PHP 将锁定文件。一旦 ZipArchive 对象被关闭,只有通过 ZipArchive :: close()或 ZipArchive 对象被销毁才会释放该锁。这可能会导致您无法删除正在添加的文件,直到锁定被释放。