PclZip：PHP 壓縮解壓縮利器的深度實戰指南

前言

在 PHP 專案中處理 ZIP 檔案是常見需求：備份部署、匯出報表、插件安裝等。PclZip 作為純 PHP 實現的 ZIP 處理庫，無需擴充模組即可運行，支援建立、讀取、解壓、增刪檔案、權限控制、註解管理等豐富功能，且 API 設計極具「PHP 風格」——參數以「常數 + 值」成對傳遞，靈活強大。本文將系統介紹其核心用法與實戰技巧。

快速上手

安裝與引入

官網：https://www.phpconcept.net/pclzip/
下載 pclzip.lib.php 放入專案，直接 include_once 即可使用。

建立壓縮檔

<?php
include_once('pclzip.lib.php');
$archive = new PclZip('backup.zip');

// 簡單模式：直接打包檔案/目錄
$v_list = $archive->create('file.txt,data/text.txt,folder');
if ($v_list == 0) die("Error: " . $archive->errorInfo(true));

// 進階模式：路徑重映射
// 將 data/file.txt、data/text.txt 打包為 install/file.txt、install/text.txt
$v_list = $archive->create(
    'data/file.txt,data/text.txt',
    PCLZIP_OPT_REMOVE_PATH, 'data',   // 移除前綴 'data'
    PCLZIP_OPT_ADD_PATH, 'install'    // 加上前綴 'install'
);
?>

全站備份一鍵腳本

<?php
require_once('pclzip.lib.php');
$zip = new PclZip("full_backup.zip");
$v_list = $zip->create(
    $_SERVER['DOCUMENT_ROOT'],
    PCLZIP_OPT_REMOVE_PATH, $_SERVER['DOCUMENT_ROOT']
);
if ($v_list == 0) {
    echo '異常：' . $zip->errorInfo(true);
} else {
    echo '備份成功，共 ' . count($v_list) . ' 個檔案';
}
?>

核心功能速查表

「淫蕩」的參數設計藝術

PclZip 的 create()、add()、extract() 等方法採用 可變長度「選項-值」對 設計：

$archive->create($filelist, OPTION1, VALUE1, OPTION2, VALUE2, ...);

這在 PHP 早期極具創新性，實現了類似「命名參數」的效果，讓單一方法支援數十種組合而不需重載。雖然現代 PHP 推薦用陣列或物件傳參，但這種設計在無嚴格類型、無命名參數的年代極大降低了 API 記憶負擔。

常見坑與避雷指南

• 記憶體限制：大檔案壓縮/解壓會將內容載入記憶體，需調整 memory_limit 或分塊處理
• 路徑分隔符：Windows 下建議統一用 /，避免 \ 導致路徑匹配失敗
• 中文檔名編碼：PclZip 內部使用系統預設編碼，跨平台部署時檔名可能亂碼，建議壓縮前統一轉 UTF-8
• 效能瓶頸：超過 100MB 或萬級檔案建議改用 ZipArchive（C 擴充模組）或系統 zip 指令
• 錯誤處理：永遠檢查回傳值是否為 0，並用 errorInfo(true) 取得詳細錯誤

現代替代方案對比

結語

PclZip 以「純 PHP、零配置、API 靈活」三大優勢，成為無法安裝擴充模組環境下的首選 ZIP 處理庫。掌握其「選項-值」參數模式與路徑重映射技巧，能輕鬆應對 90% 的壓縮解壓業務場景。對於現代高併發、大檔案專案，建議遷移至 ZipArchive 以獲得更優效能與穩定性。