萬盛學電腦網

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

PclZip 類別詳解:PHP 壓縮與解壓縮 ZIP 檔案的完整指南

PclZip 是一個功能強大的 PHP 類別,專門用於處理 ZIP 格式的壓縮檔案(相容 WinZip、PKZIP)。它不僅能建立、列出及解壓縮封存檔,還提供豐富的選項控制壓縮路徑、過濾檔案等進階功能。本文將透過實際範例,帶您快速掌握 PclZip 的核心用法。

基本環境準備

使用前請確認已引入 pclzip.lib.php 檔案:

<?php
include_once('pclzip.lib.php');
?>

建立 ZIP 檔案

範例一:基本壓縮

將多個檔案與目錄打包成 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/ 目錄中,部署套件時極為實用。

常見選項速查

  • PCLZIP_OPT_REMOVE_PATH:移除檔案路徑的指定前綴
  • PCLZIP_OPT_ADD_PATH:在封存內加上指定路徑前綴
  • PCLZIP_OPT_EXTRACT_AS_STRING:解壓縮至字串而非寫入檔案
  • PCLZIP_OPT_BY_NAME:僅處理指定檔案名稱

錯誤處理建議

永遠檢查回傳值,並善用 errorInfo(true) 取得詳細錯誤訊息,方便除錯。

PclZip 以簡潔的 API、豐富的選項,成為 PHP 專案處理 ZIP 檔案的首選工具。掌握上述核心用法,即可滿足多數壓縮/解壓縮需求。

copyright © 萬盛學電腦網 all rights reserved