PclZip 是一個功能強大的 PHP 類別,專門用於處理 ZIP 格式的壓縮檔案(相容 WinZip、PKZIP)。它不僅能建立、列出及解壓縮封存檔,還提供豐富的選項控制壓縮路徑、過濾檔案等進階功能。本文將透過實際範例,帶您快速掌握 PclZip 的核心用法。
使用前請確認已引入 pclzip.lib.php 檔案:
<?php
include_once('pclzip.lib.php');
?>
將多個檔案與目錄打包成 archive.zip:
<?php
$archive = new PclZip('archive.zip');
$v_list = $archive->create('file.txt,data/text.txt,folder');
if ($v_list == 0) {
die("Error : " . $archive->errorInfo(true));
}
?>
create() 方法接受逗號分隔的檔案/目錄路徑,回傳成功時的檔案清單陣列,失敗則回傳 0。
使用 PCLZIP_OPT_REMOVE_PATH 移除原始路徑前綴,並以 PCLZIP_OPT_ADD_PATH 指定封存內的新路徑:
<?php
$archive = new PclZip('archive.zip');
$v_list = $archive->create(
'data/file.txt,data/text.txt',
PCLZIP_OPT_REMOVE_PATH, 'data',
PCLZIP_OPT_ADD_PATH, 'install'
);
if ($v_list == 0) {
die("Error: " . $archive->errorInfo(true));
}
?>
此範例會將 data/ 目錄下的檔案壓縮至 ZIP 內的 install/ 目錄中,部署套件時極為實用。
永遠檢查回傳值,並善用 errorInfo(true) 取得詳細錯誤訊息,方便除錯。
PclZip 以簡潔的 API、豐富的選項,成為 PHP 專案處理 ZIP 檔案的首選工具。掌握上述核心用法,即可滿足多數壓縮/解壓縮需求。