PHP8 Phar::decompressFiles
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
Phar::d ecompressFiles — 解压缩当前 Phar 存档中的所有文件
说明
public Phar::decompressFiles(): boolvoid
注意:此方法需要 将 中的 设为 以适合 Phar 对象. 否则, 将抛出PharException.php.iniphar.readonly0
对于基于 tar 的 phar 存档,此方法会抛出 BadMethodCallException,作为单个压缩 文件格式不支持 tar 存档中的文件。使用 Phar::compress() 压缩整个基于 tar 的 phar 存档。
对于基于 ZIP 和 phar 的 phar 存档,此方法解压缩 法尔档案。 如果有任何文件,则必须启用 zlib 或 bzip2 扩展才能利用此功能 使用 bzip2/zlib 压缩进行压缩。 与修改 phar 内容的所有功能一样,phar.readonly INI 变量必须关闭 为了成功。
参数
此函数没有参数。
返回值
成功时返回 true, 或者在失败时返回 false。
错误/异常
如果出现以下情况,则引发 BadMethodCallException phar.readonly INI 变量处于打开状态,zlib 扩展名不可用,或者如果有任何文件是使用 bzip2 压缩和 bzip2 扩展 未启用。
示例
示例 #1 A Phar::d ecompressFiles() example
<?php
$p = new Phar('/path/to/my.phar', 0, 'my.phar');
$p['myfile.txt'] = 'hi';
$p['myfile2.txt'] = 'hi';
$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));
}
$p->decompressFiles();
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" int(4096) bool(false) bool(true) string(11) "myfile2.txt" int(4096) bool(false) bool(true) string(10) "myfile.txt" bool(false) bool(false) bool(false) string(11) "myfile2.txt" bool(false) bool(false) bool(false)
参见
- 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
- Phar::compressFiles() - 压缩当前 Phar 存档中的所有文件
- Phar::getSupportedCompression() - 返回支持的压缩算法数组
- Phar::compress() - 使用 Gzip 或 Bzip2 压缩整个 Phar 存档
- Phar::d ecompress() - 解压缩整个 Phar 存档