(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
PharData::compressFiles — 压缩当前 tar/zip 归档文件中的所有文件
对于基于 tar 的归档文件,此方法会抛出 BadMethodCallException,因为 tar 归档文件格式不支持压缩其中的单个文件。使用 PharData::compress() 压缩整个基于 tar 的归档文件。
对于基于 Zip 的归档文件,此方法使用指定的压缩方法压缩归档文件中的所有文件。必须启用 zlib 或 bzip2 扩展才能利用此功能。此外,如果任何文件已使用 bzip2/zlib 压缩,则必须启用相应的扩展才能在重新压缩之前解压缩文件。
compression
压缩必须是 Phar::GZ
、Phar::BZ2
以添加压缩,或 Phar::NONE
以删除压缩。
不返回值。
如果 phar.readonly INI 变量已启用,zlib 扩展不可用,或者如果任何文件使用 bzip2 压缩并且 bzip2 扩展未启用,则抛出 BadMethodCallException。
示例 #1 一个 PharData::compressFiles() 示例
<?php
$p = new Phar('/path/to/my.phar', 0, 'my.phar');
$p['myfile.txt'] = 'hi';
$p['myfile2.txt'] = 'hi';
foreach ($p as $file) {
var_dump($file->getFileName());
var_dump($file->isCompressed());
var_dump($file->isCompressed(Phar::BZ2));
var_dump($file->isCompressed(Phar::GZ));
}
$p->compressFiles(Phar::GZ);
foreach ($p as $file) {
var_dump($file->getFileName());
var_dump($file->isCompressed());
var_dump($file->isCompressed(Phar::BZ2));
var_dump($file->isCompressed(Phar::GZ));
}
?>
上面的示例将输出
string(10) "myfile.txt" bool(false) bool(false) bool(false) string(11) "myfile2.txt" bool(false) bool(false) bool(false) string(10) "myfile.txt" int(4096) bool(false) bool(true) string(11) "myfile2.txt" int(4096) bool(false) bool(true)