PHP Zip 擴展深度解析：壓縮檔讀取、建立、解壓縮與進階操作

PHP Zip 擴展提供完整的 ZIP 壓縮檔處理能力，支援讀取、建立、解壓縮、加密、註解編輯等操作。本文詳細說明安裝配置、核心 API (ZipArchive 物件導向介面與傳統函數式介面)、實戰範例與常見問題對策。

安裝與啟用

驗證：php -m | grep zip 或 extension_loaded('zip')

兩套 API 介面比較

ZipArchive 核心方法速查

實戰範例集

1. 建立壓縮檔 (資料夾打包)

function createZipFromDir($sourceDir, $outputZip) {
    $zip = new ZipArchive();
    if ($zip->open($outputZip, ZipArchive::CREATE | ZipArchive::OVERWRITE) !== true) {
        throw new Exception("無法建立壓縮檔: $outputZip");
    }

    $sourceDir = rtrim($sourceDir, '/\\');
    $files = new RecursiveIteratorIterator(
        new RecursiveDirectoryIterator($sourceDir, RecursiveDirectoryIterator::SKIP_DOTS),
        RecursiveIteratorIterator::SELF_FIRST
    );

    foreach ($files as $file) {
        $filePath = $file->getPathname();
        $relativePath = substr($filePath, strlen($sourceDir) + 1);

        if ($file->isDir()) {
            $zip->addEmptyDir($relativePath);
        } else {
            $zip->addFile($filePath, $relativePath);
        }
    }

    $zip->close();
    return true;
}

// 使用
createZipFromDir('/path/to/source', '/path/to/archive.zip');

2. 解壓縮到指定目錄

function extractZip($zipPath, $destDir) {
    $zip = new ZipArchive();
    $res = $zip->open($zipPath);
    if ($res !== true) {
        throw new Exception("無法開啟壓縮檔: $zipPath (錯誤碼: $res)");
    }

    // 可選：只解壓特定項目
    // $zip->extractTo($destDir, ['file1.txt', 'folder/']);

    $zip->extractTo($destDir);
    $zip->close();
    return true;
}

3. 讀取壓縮檔內容不解壓 (記憶體高效)

function readZipEntry($zipPath, $entryName) {
    $zip = new ZipArchive();
    if ($zip->open($zipPath) !== true) return false;

    // 方法 1: 完整讀入記憶體 (小檔案)
    $content = $zip->getFromName($entryName);

    // 方法 2: 串流讀取 (大檔案)
    // $stream = $zip->getStream($entryName);
    // $content = stream_get_contents($stream);
    // fclose($stream);

    $zip->close();
    return $content;
}

4. 列出壓縮檔所有項目資訊

function listZipContents($zipPath) {
    $zip = new ZipArchive();
    if ($zip->open($zipPath) !== true) return [];

    $list = [];
    for ($i = 0; $i < $zip->count(); $i++) {
        $stat = $zip->statIndex($i);
        $list[] = [
            'name' => $stat['name'],
            'size' => $stat['size'],
            'comp_size' => $stat['comp_size'],
            'crc32' => sprintf('%08X', $stat['crc']),
            'mtime' => date('Y-m-d H:i:s', $stat['mtime']),
            'method' => $stat['comp_method'], // 0=store, 8=deflate, 12=bzip2, 14=lzma, 98=zstd
            'is_dir' => substr($stat['name'], -1) === '/'
        ];
    }
    $zip->close();
    return $list;
}

5. 加密壓縮檔 (PHP 7.2+)

function createEncryptedZip($files, $outputZip, $password) {
    $zip = new ZipArchive();
    if ($zip->open($outputZip, ZipArchive::CREATE | ZipArchive::OVERWRITE) !== true) {
        throw new Exception("建立失敗");
    }

    $zip->setPassword($password);
    foreach ($files as $name => $content) {
        $zip->addFromString($name, $content);
        $zip->setEncryptionName($name, ZipArchive::EM_AES_256, $password);
    }

    $zip->close();
    return true;
}

6. 記憶體建立壓縮檔並直接輸出下載 (不落地)

function streamZipDownload($files, $filename = 'download.zip') {
    // 需啟用 zlib.output_compression = Off
    $tempZip = 'php://temp';
    $zip = new ZipArchive();
    if ($zip->open($tempZip, ZipArchive::CREATE) !== true) {
        throw new Exception("記憶體建立失敗");
    }

    foreach ($files as $name => $content) {
        $zip->addFromString($name, $content);
    }
    $zip->close();

    // 重新開啟讀取
    $zip->open($tempZip);
    header('Content-Type: application/zip');
    header("Content-Disposition: attachment; filename=\"$filename\"");
    header('Content-Length: ' . $zip->statIndex(0)['size']); // 近似值
    echo $zip->getFromIndex(0); // 實際需迴圈輸出所有項目，或使用串流
    $zip->close();
}

傳統函數式 API (舊代碼維護)

常見問題與限制

總結

PHP Zip 擴展透過 ZipArchive 提供功能完整、記憶體安全的壓縮檔操作介面。掌握建立、讀取、解壓縮、加密、串流處理等核心模式，即可滿足檔案打包下載、上傳解壓、資料備份、文件交換等多數業務需求。大檔案、高併發場景建議結合串流 API 與非同步處理佇列。

1. 上一篇文章： PHP 時區完整列表：支援的時區識別符與最佳實務設定指南
2. 下一篇文章： PHP XML 解析器完全指南：Expat 事件驅動解析、核心函數與實戰模式

PHP 入門

解決 PHP cURL 遇到 301/302 重定向報錯問題

在使用 PHP cURL 獲取遠程資源時，若目標 URL 發

FirePHP + Firebug：PHP 伺服端變數直達瀏覽器控制台的調試神器

FirePHP 是 Firebug 擴充套件，讓 PHP 透

PHP 設計模式實戰：單例模式結合責任鏈模式打造系統核心核心

模式簡介 單例模式：確保類別全域僅有一個實例，提供 get

Fedora 12 快速部署 LAMP 環境：Apache、PHP 與 MySQL 完整安裝指南

LAMP（Linux、Apache、MySQL、PHP）是經