PHP8 Phar::decompress
（PHP 5 >= 5.3.0， PHP 7， PHP 8， PECL phar >= 2.0.0）
Phar：:d ecompress — 解压缩整个 Phar 存档
说明
public Phar::decompress(?string $extension = null): ?Phar注意:此方法需要 将 中的 设为 以适合 Phar 对象. 否则, 将抛出PharException.php.iniphar.readonly0
对于基于 tar 和 phar 的 phar 存档，此方法会解压缩整个存档。
对于基于 ZIP 的 phar 存档，此方法将失败并出现异常。 必须启用 zlib 扩展才能解压缩 使用 gzip 压缩压缩的存档，并且 bzip2 扩展名必须是 启用以解压缩使用 bzip2 压缩压缩的存档。 与修改 phar 内容的所有功能一样，phar.readonly INI 变量必须关闭 为了成功。
此外，此方法会自动更改存档的文件扩展名，默认情况下用于 phar 存档或基于 tar 的 phar 存档。 或者，可以将文件扩展名指定为第二个 参数。.phar.phar.tar
参数
extension对于解压缩，默认文件扩展名 是 和 . 使用此参数指定另一个文件扩展名。注意 所有可执行的 PHAR 存档都必须在其文件名中包含。
.phar.phar.tar.phar
返回值
Phar 对象在成功时返回，失败时返回 null。
错误／异常
如果出现以下情况，则引发 BadMethodCallException phar.readonly INI 变量处于打开状态，zlib 扩展不可用，或者 bzip2 扩展 未启用。
更新日志
| 版本 | 说明 |
|---|---|
| 8.0.0 | extension现在是可为 null 的。 |
示例
示例 #1 A Phar：:d ecompress（） example
<?php
$p = new Phar('/path/to/my.phar', 0, 'my.phar.gz');
$p['myfile.txt'] = 'hi';
$p['myfile2.txt'] = 'hi';
$p3 = $p2->decompress(); // creates /path/to/my.phar
?>参见
- PharFileInfo：：getCompressedSize（） - 返回 Phar 存档中文件的实际大小（压缩）
- PharFileInfo：：isCompressed（） - 返回条目是否被压缩
- PharFileInfo：：compress（） - 使用 zlib 或 bzip2 压缩当前 Phar 条目
- PharFileInfo：:d ecompress（） - 解压缩 phar 中的当前 Phar 条目
- PharData：：compress（） - 使用 Gzip 或 Bzip2 压缩整个 tar/zip 压缩文件
- Phar：：canCompress（） - 返回 phar 扩展是否支持使用 zlib 或 bzip2 进行压缩
- Phar：：isCompressed（） - 如果压缩了整个 phar 存档（.tar.gz/tar.bz 等），则返回 Phar：：GZ 或 PHAR：：BZ2
- Phar：：compress（） - 使用 Gzip 或 Bzip2 压缩整个 Phar 存档
- Phar：：getSupportedCompression（） - 返回支持的压缩算法数组
- Phar：：compressFiles（） - 压缩当前 Phar 存档中的所有文件
- Phar：:d ecompressFiles（） - 解压缩当前 Phar 存档中的所有文件