(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
Phar::decompressFiles — 解壓縮目前 Phar 封存中的所有檔案
注意事項:
這個方法需要將 php.ini 設定
phar.readonly設為0才能作用於 Phar 物件。否則，將會拋出 PharException 例外。
對於基於 tar 的 phar 封存檔，此方法會拋出 BadMethodCallException 例外，因為檔案格式不支援壓縮 tar 封存檔中的個別檔案。請使用 Phar::compress() 來壓縮整個基於 tar 的 phar 封存檔。
對於基於 Zip 和 phar 的 phar 封存檔，此方法會解壓縮 Phar 封存檔中的所有檔案。如果任何檔案使用 bzip2/zlib 壓縮，則必須啟用 zlib 或 bzip2 延伸模組才能使用此功能。如同所有修改 phar 內容的功能一樣，phar.readonly INI 變數必須關閉才能成功執行。
這個函式沒有參數。
總是傳回 true。
如果 phar.readonly INI 變數開啟、zlib 延伸模組不可用，或者任何檔案使用 bzip2 壓縮且 bzip2 延伸模組未啟用，則會拋出 BadMethodCallException 例外。
範例 #1 Phar::decompressFiles() 範例
<?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)