ZipArchive 类

(PHP 5 >= 5.2.0, PHP 7, PHP 8, PECL zip >= 1.1.0)

简介

用 Zip 压缩的文件归档。

类摘要

class ZipArchive implements Countable {

/* 常量 */

public const int CREATE;

public const int EXCL;

public const int CHECKCONS;

public const int OVERWRITE;

public const int RDONLY;

public const int FL_NOCASE;

public const int FL_NODIR;

public const int FL_COMPRESSED;

public const int FL_UNCHANGED;

public const int FL_RECOMPRESS;

public const int FL_ENCRYPTED;

public const int FL_OVERWRITE;

public const int FL_LOCAL;

public const int FL_CENTRAL;

public const int FL_ENC_GUESS;

public const int FL_ENC_RAW;

public const int FL_ENC_STRICT;

public const int FL_ENC_UTF_8;

public const int FL_ENC_CP437;

public const int FL_OPEN_FILE_NOW;

public const int CM_DEFAULT;

public const int CM_STORE;

public const int CM_SHRINK;

public const int CM_REDUCE_1;

public const int CM_REDUCE_2;

public const int CM_REDUCE_3;

public const int CM_REDUCE_4;

public const int CM_IMPLODE;

public const int CM_DEFLATE;

public const int CM_DEFLATE64;

public const int CM_PKWARE_IMPLODE;

public const int CM_BZIP2;

public const int CM_LZMA;

public const int CM_LZMA2;

public const int CM_ZSTD;

public const int CM_XZ;

public const int CM_TERSE;

public const int CM_LZ77;

public const int CM_WAVPACK;

public const int CM_PPMD;

public const int ER_OK;

public const int ER_MULTIDISK;

public const int ER_RENAME;

public const int ER_CLOSE;

public const int ER_SEEK;

public const int ER_READ;

public const int ER_WRITE;

public const int ER_CRC;

public const int ER_ZIPCLOSED;

public const int ER_NOENT;

public const int ER_EXISTS;

public const int ER_OPEN;

public const int ER_TMPOPEN;

public const int ER_ZLIB;

public const int ER_MEMORY;

public const int ER_CHANGED;

public const int ER_COMPNOTSUPP;

public const int ER_EOF;

public const int ER_INVAL;

public const int ER_NOZIP;

public const int ER_INTERNAL;

public const int ER_INCONS;

public const int ER_REMOVE;

public const int ER_DELETED;

public const int ER_ENCRNOTSUPP;

public const int ER_RDONLY;

public const int ER_NOPASSWD;

public const int ER_WRONGPASSWD;

public const int ER_OPNOTSUPP;

public const int ER_INUSE;

public const int ER_TELL;

public const int ER_COMPRESSED_DATA;

public const int ER_CANCELLED;

public const int ER_DATA_LENGTH;

public const int ER_NOT_ALLOWED;

public const int ER_TRUNCATED_ZIP;

public const int AFL_RDONLY;

public const int AFL_IS_TORRENTZIP;

public const int AFL_WANT_TORRENTZIP;

public const int AFL_CREATE_OR_KEEP_FILE_FOR_EMPTY_ARCHIVE;

public const int OPSYS_DOS;

public const int OPSYS_AMIGA;

public const int OPSYS_OPENVMS;

public const int OPSYS_UNIX;

public const int OPSYS_VM_CMS;

public const int OPSYS_ATARI_ST;

public const int OPSYS_OS_2;

public const int OPSYS_MACINTOSH;

public const int OPSYS_Z_SYSTEM;

public const int OPSYS_CPM;

public const int OPSYS_WINDOWS_NTFS;

public const int OPSYS_MVS;

public const int OPSYS_VSE;

public const int OPSYS_ACORN_RISC;

public const int OPSYS_VFAT;

public const int OPSYS_ALTERNATE_MVS;

public const int OPSYS_BEOS;

public const int OPSYS_TANDEM;

public const int OPSYS_OS_400;

public const int OPSYS_OS_X;

public const int OPSYS_DEFAULT;

public const int EM_NONE;

public const int EM_TRAD_PKWARE;

public const int EM_AES_128;

public const int EM_AES_192;

public const int EM_AES_256;

public const int EM_UNKNOWN;

public const string LIBZIP_VERSION;

public const int LENGTH_TO_END;

public const int LENGTH_UNCHECKED;

/* 属性 */

public readonly int $lastId;

public readonly int $status;

public readonly int $statusSys;

public readonly int $numFiles;

public readonly string $filename;

public readonly string $comment;

/* 方法 */

public function addEmptyDir(string $dirname, int $flags = 0): bool

public function addFile(
    string $filepath,
    string $entryname = "",
    int $start = 0,
    int $length = ZipArchive::LENGTH_TO_END,
    int $flags = ZipArchive::FL_OVERWRITE
): bool

public function addFromString(string $name, string $content, int $flags = ZipArchive::FL_OVERWRITE): bool

public function addGlob(string $pattern, int $flags = 0, array $options = []): array|false

public function addPattern(string $pattern, string $path = ".", array $options = []): array|false

public function clearError(): void

public function close(): bool

public function count(): int

public function deleteIndex(int $index): bool

public function deleteName(string $name): bool

public function extractTo(string $pathto, array|string|null $files = null): bool

public function getArchiveComment(int $flags = 0): string|false

public function getArchiveFlag(int $flag, int $flags = 0): int

public function getCommentIndex(int $index, int $flags = 0): string|false

public function getCommentName(string $name, int $flags = 0): string|false

public function getExternalAttributesIndex(
    int $index,
    int &$opsys,
    int &$attr,
    int $flags = 0
): bool

public function getExternalAttributesName(
    string $name,
    int &$opsys,
    int &$attr,
    int $flags = 0
): bool

public function getFromIndex(int $index, int $len = 0, int $flags = 0): string|false

public function getFromName(string $name, int $len = 0, int $flags = 0): string|false

public function getNameIndex(int $index, int $flags = 0): string|false

public function getStatusString(): string

public function getStream(string $name): resource|false

public function getStreamIndex(int $index, int $flags = 0): resource|false

public function getStreamName(string $name, int $flags = 0): resource|false

public static function isCompressionMethodSupported(int $method, bool $enc = true): bool

public static function isEncryptionMethodSupported(int $method, bool $enc = true): bool

public function locateName(string $name, int $flags = 0): int|false

public function open(string $filename, int $flags = 0): bool|int

public function registerCancelCallback(callable $callback): bool

public function registerProgressCallback(float $rate, callable $callback): bool

public function renameIndex(int $index, string $new_name): bool

public function renameName(string $name, string $new_name): bool

public function replaceFile(
    string $filepath,
    int $index,
    int $start = 0,
    int $length = ZipArchive::LENGTH_TO_END,
    int $flags = 0
): bool

public function setArchiveComment(string $comment): bool

public function setArchiveFlag(int $flag, int $value): bool

public function setCommentIndex(int $index, string $comment): bool

public function setCommentName(string $name, string $comment): bool

public function setCompressionIndex(int $index, int $method, int $compflags = 0): bool

public function setCompressionName(string $name, int $method, int $compflags = 0): bool

public function setEncryptionIndex(int $index, int $method, #[\SensitiveParameter] ?string $password = null): bool

public function setEncryptionName(string $name, int $method, #[\SensitiveParameter] ?string $password = null): bool

public function setExternalAttributesIndex(
    int $index,
    int $opsys,
    int $attr,
    int $flags = 0
): bool

public function setExternalAttributesName(
    string $name,
    int $opsys,
    int $attr,
    int $flags = 0
): bool

public function setMtimeIndex(int $index, int $timestamp, int $flags = 0): bool

public function setMtimeName(string $name, int $timestamp, int $flags = 0): bool

public function setPassword(#[\SensitiveParameter] string $password): bool

public function statIndex(int $index, int $flags = 0): array|false

public function statName(string $name, int $flags = 0): array|false

public function unchangeAll(): bool

public function unchangeArchive(): bool

public function unchangeIndex(int $index): bool

public function unchangeName(string $name): bool

}

属性

lastId: 最后新增的条目（文件或目录）索引值。从 PHP 8.0.0 和 PECL zip 1.18.0 开始可用。
status: Zip 归档的状态。从 PHP 8.0.0 和 PECL zip 1.18.0 开始，可用于关闭归档。
statusSys: Zip 归档的系统状态。从 PHP 8.0.0 和 PECL zip 1.18.0 开始，可用于关闭归档。
numFiles: 归档里的文件数
filename: 在文件系统里的文件名
comment: 归档里的注释

ZipArchive::addEmptyDir — Add a new directory
ZipArchive::addFile — Adds a file to a ZIP archive from the given path
ZipArchive::addFromString — Add a file to a ZIP archive using its contents
ZipArchive::addGlob — Add files from a directory by glob pattern
ZipArchive::addPattern — Add files from a directory by PCRE pattern
ZipArchive::clearError — 清除状态错误消息、系统和/或 zip 消息
ZipArchive::close — Close the active archive (opened or newly created)
ZipArchive::count — Counts the number of files in the archive
ZipArchive::deleteIndex — Delete an entry in the archive using its index
ZipArchive::deleteName — Delete an entry in the archive using its name
ZipArchive::extractTo — 解压缩文件
ZipArchive::getArchiveComment — Returns the Zip archive comment
ZipArchive::getArchiveFlag — 返回 Zip 归档全局 flag 的值
ZipArchive::getCommentIndex — Returns the comment of an entry using the entry index
ZipArchive::getCommentName — Returns the comment of an entry using the entry name
ZipArchive::getExternalAttributesIndex — Retrieve the external attributes of an entry defined by its index
ZipArchive::getExternalAttributesName — Retrieve the external attributes of an entry defined by its name
ZipArchive::getFromIndex — Returns the entry contents using its index
ZipArchive::getFromName — Returns the entry contents using its name
ZipArchive::getNameIndex — Returns the name of an entry using its index
ZipArchive::getStatusString — Returns the status error message, system and/or zip messages
ZipArchive::getStream — Get a file handler to the entry defined by its name (read only)
ZipArchive::getStreamIndex — Get a file handler to the entry defined by its index (read only)
ZipArchive::getStreamName — Get a file handler to the entry defined by its name (read only)
ZipArchive::isCompressionMethodSupported — Check if a compression method is supported by libzip
ZipArchive::isEncryptionMethodSupported — Check if a encryption method is supported by libzip
ZipArchive::locateName — Returns the index of the entry in the archive
ZipArchive::open — Open a ZIP file archive
ZipArchive::registerCancelCallback — Register a callback to allow cancellation during archive close.
ZipArchive::registerProgressCallback — Register a callback to provide updates during archive close.
ZipArchive::renameIndex — Renames an entry defined by its index
ZipArchive::renameName — Renames an entry defined by its name
ZipArchive::replaceFile — Replace file in ZIP archive with a given path
ZipArchive::setArchiveComment — Set the comment of a ZIP archive
ZipArchive::setArchiveFlag — 设置 ZIP 归档的全局 flag
ZipArchive::setCommentIndex — Set the comment of an entry defined by its index
ZipArchive::setCommentName — Set the comment of an entry defined by its name
ZipArchive::setCompressionIndex — Set the compression method of an entry defined by its index
ZipArchive::setCompressionName — Set the compression method of an entry defined by its name
ZipArchive::setEncryptionIndex — Set the encryption method of an entry defined by its index
ZipArchive::setEncryptionName — Set the encryption method of an entry defined by its name
ZipArchive::setExternalAttributesIndex — Set the external attributes of an entry defined by its index
ZipArchive::setExternalAttributesName — Set the external attributes of an entry defined by its name
ZipArchive::setMtimeIndex — Set the modification time of an entry defined by its index
ZipArchive::setMtimeName — Set the modification time of an entry defined by its name
ZipArchive::setPassword — Set the password for the active archive
ZipArchive::statIndex — Get the details of an entry defined by its index
ZipArchive::statName — Get the details of an entry defined by its name
ZipArchive::unchangeAll — Undo all changes done in the archive
ZipArchive::unchangeArchive — Revert all global changes done in the archive
ZipArchive::unchangeIndex — Revert all changes done to an entry at the given index
ZipArchive::unchangeName — Revert all changes done to an entry with the given name

ZipArchive 类

简介

类摘要

属性

目录