使用zip_read() 函數時提示“supplied argument is not a valid Zip directory resource”，這是怎麼回事？如何解決？

M66 2025-07-10

在使用PHP 的zip_read()函數處理ZIP 文件時，遇到錯誤提示“supplied argument is not a valid Zip directory resource” 是比較常見的問題。本文將詳細分析這個錯誤的原因，並介紹如何正確使用zip_read()以及如何避免和解決該問題。

什麼是zip_read()函數？

zip_read()是PHP 的Zip 擴展提供的一個函數，用於讀取ZIP 壓縮包中的條目（文件或目錄）。它的使用流程一般是：

使用zip_open()打開一個ZIP 文件，返回一個資源句柄（resource）。
使用zip_read()讀取該資源中的下一個條目。
處理條目信息，比如獲取文件名、大小等。

函數簽名示例：

 $zip = zip_open('example.zip');
if (is_resource($zip)) {
    while ($entry = zip_read($zip)) {
        echo zip_entry_name($entry) . "\n";
    }
    zip_close($zip);
}

錯誤提示“supplied argument is not a valid Zip directory resource”含義

該錯誤表明傳遞給zip_read()函數的參數不是一個有效的ZIP 目錄資源。通常這意味著：

zip_open()返回了false ，未能成功打開ZIP 文件。
傳遞給zip_read()的參數並非zip_open()返回的資源。
資源已經被關閉或損壞。

簡言之， zip_read()需要一個有效的ZIP 資源句柄作為參數，否則就會報該錯誤。

常見引發錯誤的原因及解決方案

1. 文件路徑錯誤或文件不存在

如果傳遞給zip_open()的文件路徑錯誤或文件不存在， zip_open()會返回false ，而不是資源。

解決方法：確保文件路徑正確，文件存在且可讀。

示例：

 $zipFile = 'path/to/file.zip';
if (!file_exists($zipFile)) {
    die("文件不存在！");
}
$zip = zip_open($zipFile);
if (!is_resource($zip)) {
    die("無法打開 ZIP 文件！");
}

2. 傳遞給zip_read()的參數不是資源

可能程序邏輯錯誤，傳遞了非資源類型給zip_read() 。

解決方法：調用前檢測zip_open()返回值是否為資源。

 if (is_resource($zip)) {
    while ($entry = zip_read($zip)) {
        // 處理條目
    }
} else {
    echo "打開 ZIP 文件失敗。";
}

3. 資源已關閉或使用順序錯誤

如果先調用了zip_close()關閉資源，然後又調用zip_read() ，會導致該錯誤。

解決方法：保證調用順序正確，關閉資源前不要再調用zip_read() 。

4. PHP 擴展未安裝或配置問題

如果PHP 沒有啟用Zip 擴展，調用相關函數可能失敗。

解決方法：檢查PHP 配置，確保啟用Zip 擴展。

 php -m | grep zip

如果沒有顯示zip ，需要在php.ini中開啟或安裝擴展。

綜上示例：正確使用zip_read()的範例代碼

<?php
$zipFile = 'm66.net/files/test.zip'; // 注意替換為實際文件路徑

// 打開 ZIP 文件
$zip = zip_open($zipFile);

if (!is_resource($zip)) {
    die("無法打開 ZIP 文件或文件格式錯誤。");
}

while (($entry = zip_read($zip)) !== false) {
    echo "文件名: " . zip_entry_name($entry) . "\n";
}

zip_close($zip);
?>

總結

出現“supplied argument is not a valid Zip directory resource” 錯誤，主要是因為傳入的參數不是有效的ZIP 資源。通常需要：

確保ZIP 文件存在且路徑正確。
確保zip_open()返回的是資源，而非false 。
正確使用資源，不要提前關閉。
確認PHP Zip 擴展已安裝和啟用。

正確排查和處理以上問題，能夠有效避免該錯誤。希望本文能幫助你順利解決zip_read()使用中的疑惑。