PHP8 PharData::compressFiles

2024-02-22 11:48 更新

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

PharData::compressFiles — 压缩当前 tar/zip 存档中的所有文件

说明

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

对于基于 tar 的存档,此方法会引发 BadMethodCallException,作为单个压缩 文件格式不支持 tar 存档中的文件。使用 PharData::compress() 压缩整个基于 tar 的存档。

对于基于 ZIP 的存档,此方法压缩 使用指定的压缩进行存档。 必须启用 zlib 或 bzip2 扩展才能利用此功能。此外,如果有任何文件 已经使用 bzip2/zlib 压缩进行压缩,相应的扩展名必须是 启用以便在重新压缩之前解压缩文件。

参数 

compression

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

返回值 ¶

没有返回值。

错误/异常 

如果出现以下情况,则引发 BadMethodCallException phar.readonly INI 变量处于打开状态,zlib 扩展名不可用,或者如果有任何文件是使用 bzip2 压缩和 bzip2 扩展 未启用。

示例 

示例 #1 A PharData::compressFiles() example

<?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)

参见 

  • PharFileInfo::getCompressedSize() - 返回 Phar 存档中文件的实际大小(压缩)
  • PharFileInfo::isCompressed() - 返回条目是否被压缩
  • PharFileInfo::compress() - 使用 zlib 或 bzip2 压缩当前 Phar 条目
  • PharFileInfo::d ecompress() - 解压缩 phar 中的当前 Phar 条目
  • Phar::canCompress() - 返回 phar 扩展是否支持使用 zlib 或 bzip2 进行压缩
  • Phar::isCompressed() - 如果压缩了整个 phar 存档(.tar.gz/tar.bz 等),则返回 Phar::GZ 或 PHAR::BZ2
  • PharData::d ecompressFiles() - 解压缩当前zip压缩文件中的所有文件
  • Phar::getSupportedCompression() - 返回支持的压缩算法数组
  • PharData::compress() - 使用 Gzip 或 Bzip2 压缩整个 tar/zip 压缩文件
  • PharData::d ecompress() - 解压缩整个 Phar 存档


以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号