如何在循環中正確使用zip_read()

M66 2025-06-04

在使用PHP 處理ZIP 壓縮文件時， zip_read()是一個常見的函數，用於逐個讀取壓縮文件中的條目（entry）。不過，在實際應用中，不少開發者在循環中使用該函數時容易出錯，導致讀取失敗或邏輯不正確。本文將詳細介紹如何正確使用zip_read()來讀取壓縮包中的所有文件。

基本使用方法

PHP 提供了一組與ZIP 文件操作相關的函數，例如zip_open() 、 zip_read()和zip_entry_read() 。其中， zip_read()用於從打開的ZIP 文件資源中依次讀取條目。

一個典型的讀取壓縮文件內容的代碼結構如下：

<code> $zip = zip_open("example.zip"); if (is_resource($zip)) { while ($entry = zip_read($zip)) { echo "Name: " . zip_entry_name($entry) . "\n"; if (zip_entry_open($zip, $entry, "r")) { $contents = zip_entry_read($entry, zip_entry_filesize($entry)); echo "Contents: " . $contents . "\n"; zip_entry_close($entry); } } zip_close($zip); } else { echo "無法打開ZIP 文件"; } </code>

上述代碼中， zip_open()打開壓縮包， zip_read()在while循環中逐個讀取條目，直到沒有更多的entry 為止。

常見錯誤

未在循環中持續調用zip_read()
一些開發者誤以為可以一次性讀取所有條目，或者嘗試用foreach結構來操作zip_read() ，這樣是不可行的。 zip_read()是一個順序讀取函數，必須放在while循環中才能正確迭代所有內容。
未關閉條目或ZIP 文件
忘記調用zip_entry_close()和zip_close()會導致資源洩露，特別是在處理大文件或多個ZIP 包時影響性能。
未處理壓縮包中文件的編碼問題
如果ZIP 文件中包含非UTF-8 編碼的文件名，可能會導致zip_entry_name()顯示亂碼。可以使用mb_convert_encoding()進行轉碼：
<code> $filename = mb_convert_encoding(zip_entry_name($entry), "UTF-8", "CP936"); </code>

實戰示例：遍歷並保存所有文件到本地

假設我們有一個上傳的ZIP 文件，我們希望將所有文件解壓並保存到本地uploads/目錄下：

<code> $zip = zip_open($_FILES['file']['tmp_name']); if (is_resource($zip)) { while ($entry = zip_read($zip)) { $name = zip_entry_name($entry); $save_path = "uploads/" . basename($name);

     if (zip_entry_open($zip, $entry, "r")) {
        $contents = zip_entry_read($entry, zip_entry_filesize($entry));
        file_put_contents($save_path, $contents);
        zip_entry_close($entry);
    }
}
zip_close($zip);
echo "解壓完成";

} else {
echo "上傳的文件無法打開";
}
</code>

在部署到線上時，記得驗證路徑、權限並做好安全處理，防止路徑穿越（Directory Traversal）攻擊。

調試技巧

如果你不確定zip_read()是否正確返回entry，可以添加調試語句：

<code> var_dump($entry); </code>

另外，也可以打印文件名來確認解析的內容：

<code> echo "正在讀取文件：" . zip_entry_name($entry) . "\n"; </code>

總結

在PHP 中使用zip_read()讀取ZIP 文件時，務必注意以下幾點：

使用while ($entry = zip_read($zip))循環；
每次讀取後都使用zip_entry_open()和zip_entry_close() ；
最後調用zip_close()關閉資源；
注意文件名編碼和目錄安全問題。

zip_read