PHP8 Phar::decompress

2024-02-20 09:17 更新

(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.0extension现在是可为 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 存档中的所有文件


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

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号