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 压缩或 zlib 压缩压缩 Phar 档案中的文件。必须启用 bzip2 或 zlib 扩展才能利用此功能。此外，如果文件已压缩，则必须启用相应的扩展才能解压缩文件。与所有修改 phar 内容的功能一样，如果文件在 Phar 档案中，则必须关闭 phar.readonly INI 变量才能成功。 PharData 档案中的文件没有此限制。

参数

compression: 压缩必须是 Phar::GZ 或 Phar::BZ2。

返回值

成功时返回 true，失败时返回 false。

错误/异常

如果 phar.readonly INI 变量已打开，或者如果 bzip2/zlib 扩展不可用，则抛出 BadMethodCallException。

范例

范例 #1 一个 PharFileInfo::compress() 范例

<?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 '创建/修改 my.phar 操作失败: ', $e;
}
?>

上面的例子将输出

bool(false)
bool(true)

参见

PharFileInfo::getCompressedSize() - 返回 Phar 档案中文件的实际大小（含压缩）
PharFileInfo::isCompressed() - 返回条目是否已压缩
PharFileInfo::decompress() - 解压缩 phar 中的当前 Phar 项
Phar::canCompress() - 返回 phar 扩展是否支持使用 zlib 或 bzip2 进行压缩
Phar::isCompressed() - 如果整个 phar 档案已压缩（.tar.gz/tar.bz 等），则返回 Phar::GZ 或 PHAR::BZ2
Phar::compressFiles() - 压缩当前 Phar 档案中的所有文件
Phar::decompressFiles() - 解压缩当前 Phar 档案中的所有文件
Phar::compress() - 使用 Gzip 或 Bzip2 压缩压缩整个 Phar 档案
Phar::decompress() - 解压缩整个 Phar 档案
Phar::getSupportedCompression() - 返回支持的压缩算法数组

改进此页面

了解如何改进此页面 • 提交拉取请求 • 报告错误

＋添加笔记

用户贡献笔记

此页面没有用户贡献的笔记。