(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)
PharData::compressFiles — 壓縮目前 tar/zip 封存檔中的所有檔案
對於基於 tar 的封存檔，此方法會擲出 BadMethodCallException 例外，因為檔案格式不支援壓縮 tar 封存檔中的個別檔案。請使用 PharData::compress() 來壓縮整個基於 tar 的封存檔。
對於基於 Zip 的壓縮檔，此方法會使用指定的壓縮方式壓縮檔案庫中的所有檔案。必須啟用 zlib 或 bzip2 延伸模組才能使用此功能。此外，如果任何檔案已使用 bzip2/zlib 壓縮，則必須啟用相對應的延伸模組，才能在重新壓縮之前先將檔案解壓縮。
compression壓縮方式必須是 Phar::GZ、Phar::BZ2 進行壓縮，或 Phar::NONE 移除壓縮。
不回傳任何值。
如果 phar.readonly INI 變數為開啟狀態、zlib 延伸模組無法使用，或任何檔案使用 bzip2 壓縮且 bzip2 延伸模組未啟用，則會擲出 BadMethodCallException 例外。
範例 #1 PharData::compressFiles() 範例
<?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)