PclZip 是純 PHP 實作的 ZIP 壓縮庫,無需系統安裝擴充套件,支援建立、列出、解壓縮 Zip 檔 (相容 WinZip、PKZIP),適合虛擬主機或無法安裝 ZipArchive 擴充套件的環境。
pclzip.lib.php 單一檔案即可使用。<?php
require_once 'pclzip.lib.php';
$zipFile = time() . '_backup.zip'; // 輸出檔名
$sourceDir = '/path/to/source/folder'; // 要壓縮的資料夾
$archive = new PclZip($zipFile);
// PCLZIP_OPT_REMOVE_ALL_PATH: 移除原始絕對路徑
// PCLZIP_OPT_ADD_PATH: 在壓縮包內統一加上前綴資料夾名
$list = $archive->create($sourceDir, PCLZIP_OPT_REMOVE_ALL_PATH, PCLZIP_OPT_ADD_PATH, 'myfolder');
if ($list === 0) {
die('Error: ' . $archive->errorInfo(true));
}
echo "壓縮成功,共 " . count($list) . " 個檔案。";
$archive = new PclZip('backup.zip');
$list = $archive->extract(PCLZIP_OPT_PATH, '/target/dir', PCLZIP_OPT_REPLACE, 'always');
if ($list === 0) die('解壓失敗: ' . $archive->errorInfo(true));
echo "解壓完成。";
$list = $archive->listContent();
foreach ($list as $file) {
echo "{$file['filename']} ({$file['stored_size']} bytes, {$file['compressed_size']} compressed)\n";
}
| 常數 | 用途 |
|---|---|
PCLZIP_OPT_PATH | 解壓目標目錄 |
PCLZIP_OPT_ADD_PATH | 壓縮時加在檔案路徑前的前綴 |
PCLZIP_OPT_REMOVE_ALL_PATH | 壓縮時移除所有原始路徑資訊 |
PCLZIP_OPT_REMOVE_PATH | 移除指定的路徑前綴 |
PCLZIP_OPT_REPLACE | 檔案存在時覆蓋模式 (always/if_newer) |
PCLZIP_OPT_EXTRACT_AS_STRING | 解壓到字串變數而非檔案 |
PCLZIP_OPT_BY_NAME | 僅處理指定檔案名 (陣列) |
PCLZIP_OPT_BY_EREG | 僅處理符合正則的檔案 |
PCLZIP_OPT_BY_PREG | 僅處理符合 PCRE 正則的檔案 |
PCLZIP_OPT_SET_CHMOD | 設定解壓檔案權限 |
memory_limit 或 max_execution_time。ZipArchive 擴充套件** (C 實作,速度快數十倍)。if ($list === 0) {
// errorInfo(true) 回傳陣列,false 回傳字串
$err = $archive->errorInfo(true);
echo "代碼: {$err['code']}, 訊息: {$err['message']}";
}