在线文档教程
PHP
压缩 | Compression

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 对象被销毁才会释放该锁。这可能会导致您无法删除正在添加的文件,直到锁定被释放。