萬盛學電腦網

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

PHPZip 類別實現檔案壓縮打包:純 PHP 無擴展依賴、支援目錄遞歸

PHPZip 類別純 PHP 實現 ZIP 封裝,基於 gzcompress (zlib),無需 ZipArchive 擴展,支援目錄遞歸掃描、多檔案打包。

類別核心結構

class PHPZip {
    var $datasec = [];      // 檔案資料區
    var $ctrl_dir = [];     // 中央目錄區
    var $eof_ctrl_dir = "\x50\x4b\x05\x06\x00\x00\x00\x00";
    var $old_offset = 0;
    
    public function Zip($dir, $zipfilename) { /* 入口:掃描→壓縮→寫入 */ }
    private function GetFileList($dir, $pref='') { /* 遞歸掃描目錄 */ }
    private function unix2DosTime($unixtime=0) { /* Unix 時間轉 DOS 格式 */ }
    public function addFile($data, $name, $time=0) { /* 加入單一檔案 */ }
    private function file() { /* 組裝完整 ZIP 二進位內容 */ }
}

使用範例

$zip = new PHPZip();
// 方式一:打包整個目錄
$zip->Zip('/path/to/source_dir', '/path/to/output.zip');

// 方式二:打包指定檔案陣列
$files = [
    '/path/file1.txt',
    '/path/file2.jpg',
];
$zip->Zip($files, '/path/to/output.zip');

核心流程解析

  1. 掃描:GetFileList 遞歸遍歷,回傳相對路徑陣列
  2. 讀取壓縮:逐檔 fread → gzcompress → addFile 存入 $datasec
  3. 建立中央目錄:記錄每檔案元資料(名稱、大小、CRC32、偏移、時間)
  4. 組裝輸出:file() 依 ZIP 格式規格串聯:區域檔案頭 + 壓縮資料 + 中央目錄 + 結束記錄
  5. 寫入檔案:fwrite 二進位輸出

ZIP 格式關鍵結構

[區域檔案頭 1][檔案資料 1]...[區域檔案頭 N][檔案資料 N][中央目錄 1]...[中央目錄 N][結束中央目錄記錄]
  • 區域檔案頭:標記 PK\003\004、版本、標誌、壓縮方法、時間、CRC32、壓縮/非壓縮大小、檔名長度、額外欄位長度、檔名、額外欄位
  • 中央目錄:類似區域頭但含檔案偏移量、內部/外部屬性

限制與注意

  • 記憶體:全量讀入記憶體,大檔案/大目錄易 OOM
  • 效能:純 PHP 壓縮慢於 C 擴展 (ZipArchive)
  • 功能缺失:不支援加密、ZIP64 (4GB+)、分卷、符號連結保留
  • 相容性:產出標準 ZIP,主流解壓工具皆可讀取

生產環境建議

// 優先使用 ZipArchive (PHP 內建擴展)
$zip = new ZipArchive();
$zip->open('output.zip', ZipArchive::CREATE);
$zip->addFile('large_file.log', 'logs/large_file.log');
$zip->close();

// 或使用 PhpZip (composer require nelexa/zip) - 串流式、低記憶體
use Nelexa\Zip\ZipArchive;
$zip = new ZipArchive();
$zip->open('output.zip');
$zip->addFile('large_file.log', 'logs/large_file.log');
$zip->close();

PHPZip 適合無擴展環境、小型打包需求;生產環境大量/大檔案壓縮請用 ZipArchive 或串流庫。

copyright © 萬盛學電腦網 all rights reserved