PHP Conference Japan 2024

Phar::compressFiles

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL phar >= 2.0.0)

Phar::compressFiles壓縮目前 Phar 封存中的所有檔案

說明

public Phar::compressFiles(int $compression): void

注意:

此方法需要將 php.ini 設定 phar.readonly 設為 0 才能讓 Phar 物件正常運作。否則,將會拋出 PharException 例外。

對於 tar 格式的 Phar 封存檔,此方法會拋出 BadMethodCallException 例外,因為 tar 封存檔格式不支援單獨壓縮檔案。請使用 Phar::compress() 來壓縮整個 tar 格式的 Phar 封存檔。

對於 Zip 格式和 phar 格式的 Phar 封存檔,此方法會使用指定的壓縮方式壓縮 Phar 封存檔中的所有檔案。必須啟用 zlibbzip2 延伸模組才能使用此功能。此外,如果任何檔案已經使用 bzip2/zlib 壓縮,則必須啟用各自的延伸模組,以便在重新壓縮之前先解壓縮檔案。如同所有修改 Phar 封存檔內容的功能一樣,必須關閉 phar.readonly INI 變數才能成功執行。

參數

compression

壓縮方式必須是 Phar::GZPhar::BZ2 進行壓縮,或是 Phar::NONE 移除壓縮。

傳回值

不傳回任何值。

錯誤/例外

如果 phar.readonly INI 變數為開啟狀態、zlib 延伸模組無法使用,或者任何檔案使用 bzip2 壓縮且 bzip2 延伸模組未啟用,則會拋出 BadMethodCallException 例外。

範例

範例 #1 Phar::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)

另請參閱

新增註解

使用者貢獻的註解 1 則註解

3
alex at phpguide dot co dot il
13 年前
壓縮整個封存檔
$phar->compress();
會覆蓋您的 stub 檔案。

使用 compressFiles 來壓縮檔案,同時保持您自己的 stub 檔案完整(不會被壓縮)。
壓縮效果稍微差一點(因為有一個檔案未壓縮),但可讓您自己的 stub 檔案在瀏覽器請求時執行。

不要搞錯,壓縮並不會提高程式碼的安全性或將其有效地混淆。您壓縮的 Phar 原始碼仍然很容易閱讀。
To Top