PHP8 PharFileInfo::compress
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
PharFileInfo::compress — 使用 zlib 或 bzip2 压缩当前 Phar 条目
说明
public PharFileInfo::compress(int $compression): bool
此方法使用 bzip2 压缩来压缩 Phar 存档中的文件 或 zlib 压缩。 必须启用 bzip2 或 zlib 扩展才能采取 此功能的优点。此外,如果文件已压缩, 必须按顺序启用相应的扩展 解压缩文件。与修改 一个 phar,即 phar.readonly INI 变量 如果文件位于 Phar 存档中,则必须关闭才能成功。PharData 存档中的文件没有 此限制。
参数
compression
压缩必须是
Phar::GZ
或Phar::BZ2
。
返回值
成功时返回 true, 或者在失败时返回 false。
错误/异常
如果出现以下情况,则引发 BadMethodCallException phar.readonly INI 变量处于打开状态,或者如果 bzip2/zlib 扩展不可用。
示例
示例 #1 A PharFileInfo::compress() example
<?php
try {
$p = new Phar('/path/to/my.phar', 0, 'my.phar');
$p['myfile.txt'] = 'hi';
$file = $p['myfile.txt'];
var_dump($file->isCompressed(Phar::BZ2));
$p['myfile.txt']->compress(Phar::BZ2);
var_dump($file->isCompressed(Phar::BZ2));
} catch (Exception $e) {
echo 'Create/modify operations on my.phar failed: ', $e;
}
?>
以上示例会输出:
bool(false) bool(true)
参见
- PharFileInfo::getCompressedSize() - 返回 Phar 存档中文件的实际大小(压缩)
- PharFileInfo::isCompressed() - 返回条目是否被压缩
- PharFileInfo::d ecompress() - 解压缩 phar 中的当前 Phar 条目
- Phar::canCompress() - 返回 phar 扩展是否支持使用 zlib 或 bzip2 进行压缩
- Phar::isCompressed() - 如果压缩了整个 phar 存档(.tar.gz/tar.bz 等),则返回 Phar::GZ 或 PHAR::BZ2
- Phar::compressFiles() - 压缩当前 Phar 存档中的所有文件
- Phar::d ecompressFiles() - 解压缩当前 Phar 存档中的所有文件
- Phar::compress() - 使用 Gzip 或 Bzip2 压缩整个 Phar 存档
- Phar::d ecompress() - 解压缩整个 Phar 存档
- Phar::getSupportedCompression() - 返回支持的压缩算法数组