萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PclZip:PHP 輕鬆實現 ZIP 壓縮與解壓縮

PclZip 是純 PHP 實作的 ZIP 壓縮庫,無需系統安裝擴充套件,支援建立、列出、解壓縮 Zip 檔 (相容 WinZip、PKZIP),適合虛擬主機或無法安裝 ZipArchive 擴充套件的環境。

官方資源

快速上手

壓縮資料夾

<?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設定解壓檔案權限

效能與限制

  • 純 PHP 實作,**大檔案 (超過 100MB) 壓縮/解壓較慢、記憶體佔用高**,易觸發 memory_limit 或 max_execution_time。
  • 生產環境大量/大檔案操作,**強烈建議安裝原生 ZipArchive 擴充套件** (C 實作,速度快數十倍)。
  • PclZip 適合:小檔案打包、無法安裝擴充套件的共享主機、快速原型開發。

錯誤處理

if ($list === 0) {
    // errorInfo(true) 回傳陣列,false 回傳字串
    $err = $archive->errorInfo(true);
    echo "代碼: {$err['code']}, 訊息: {$err['message']}";
}
copyright © 萬盛學電腦網 all rights reserved