2024 年 PHP 大会日本

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