Phar::compressFiles

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)

Phar::compressFiles压缩当前 Phar 归档中的所有文件

描述

public Phar::compressFiles(int $compression): void

注意:

此方法需要 php.ini 设置 phar.readonly 设置为 0 才能对 Phar 对象起作用。否则,将抛出 PharException

对于基于 tar 的 phar 归档,此方法会抛出 BadMethodCallException,因为 tar 归档中单个文件的压缩不受文件格式支持。使用 Phar::compress() 来压缩整个基于 tar 的 phar 归档。

对于基于 Zip 和基于 phar 的 phar 归档,此方法使用指定的压缩方法压缩 Phar 归档中的所有文件。必须启用 zlibbzip2 扩展才能利用此功能。此外,如果任何文件已使用 bzip2/zlib 压缩,则必须启用相应的扩展才能在重新压缩之前解压缩文件。与修改 phar 内容的所有功能一样,phar.readonly INI 变量必须关闭才能成功。

参数

compression

压缩必须是 Phar::GZPhar::BZ2 之一以添加压缩,或者 Phar::NONE 以删除压缩。

返回值

不返回值。

错误/异常

如果 phar.readonly INI 变量已开启,zlib 扩展不可用,或者如果任何文件使用 bzip2 压缩且 bzip2 扩展未启用,则抛出 BadMethodCallException

示例

示例 #1 Phar::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)

参见

添加说明

用户贡献说明 1 个说明

alex at phpguide dot co dot il
13 年前
压缩整个归档
$phar->compress();
会覆盖您的存根文件。

使用 compressFiles 来压缩文件,同时保持您自己的存根完好无损(不被压缩)。
压缩有点价值(因为一个文件没有被压缩),但它允许您执行带有浏览器请求的自己的存根文件。

不要混淆,压缩不会提高代码的安全级别或使其足够模糊。您压缩的 phar 的源代码仍然很容易阅读。
To Top