ZipArchive::addFile
Adds a file to a ZIP archive from the given path
Description
public bool ZipArchive::addFile(
string $filepath,
string $entryname = "",
int $start = 0,
int $length = ZipArchive::LENGTH_TO_END,
int $flags = ZipArchive::FL_OVERWRITE
)
Note: For maximum portability, it is recommended to always use forward slashes (/) as directory separator in ZIP filenames.
Parameters
-
filepath
-
The path to the file to add.
-
entryname
-
If supplied and not empty, this is the local name inside the ZIP archive that will override the filepath.
-
start
-
For partial copy, start position.
-
length
-
For partial copy, length to be copied,
if ZipArchive::LENGTH_TO_END (0) the file size is used,
if ZipArchive::LENGTH_UNCHECKED the whole file is used
(starting from start).
-
flags
-
Bitmask consisting of
ZipArchive::FL_OVERWRITE,
ZipArchive::FL_ENC_GUESS,
ZipArchive::FL_ENC_UTF_8,
ZipArchive::FL_ENC_CP437,
ZipArchive::FL_OPEN_FILE_NOW.
The behaviour of these constants is described on the
ZIP constants page.
Return Values
Returns true on success or false on failure.
Examples
This example opens a ZIP file archive
test.zip and add
the file /path/to/index.txt.
as 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';
}
?>
Notes
Note:
When a file is set to be added to the archive, PHP will lock the file. The
lock is only released once the ZipArchive object
has been closed, either via ZipArchive::close or
the ZipArchive object being destroyed. This may
prevent you from being able to delete the file being added until after the
lock has been released.