萬盛學電腦網

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

CodeIgniter 框架 Zip 壓縮類使用詳解與避坑指南

載入類庫

$this->load->library('zip'); // 手動載入
// 或在 application/config/autoload.php 中自動載入
$autoload['libraries'] = ['database', 'session', 'zip'];

核心方法速查

方法說明
read_file($path, $archive_name)添加單個文件到壓縮包
read_dir($path, $preserve_dirs = TRUE)遞歸添加整個目錄,$preserve_dirs=false 扁平化存放
download($filename)輸出壓縮包並觸發瀏覽器下載
archive($filepath)保存壓縮包到服務器路徑
get_zip()返回壓縮包二進制內容(不輸出)
clear_data()清空當前壓縮數據,可復用對象

完整示例:打包網站根目錄供下載

<?php
class Backup extends CI_Controller {
    public function download() {
        $this->load->library('zip');
        $path = FCPATH; // 網站根目錄

        // 讀取目錄,不保留絕對路徑結構
        $this->zip->read_dir($path, FALSE);

        // 觸發下載
        $this->zip->download('my_backup_' . date('Ymd_His') . '.zip');
    }

    public function save_to_server() {
        $this->load->library('zip');
        $this->zip->read_dir(FCPATH . 'uploads', TRUE);
        $savePath = FCPATH . 'backups/backup_' . date('Ymd') . '.zip';
        $this->zip->archive($savePath);
        echo "備份已保存至 $savePath";
    }
}

常見坑與解決

  • 類未找到:檢查 autoload.php 或手動 $this->load->library('zip'),CI3/4 均內置。
  • 大目錄內存溢出:read_dir 會將所有文件內容讀入內存再壓縮。大目錄請分批處理或改用 CLI 調用系統 zip 命令(exec('zip -r ...'))。
  • download() 會發送 Header,調用前**絕不能有任何輸出**(包括 BOM、空白、echo)。
  • 中文文件名亂碼:CI Zip 類基於 PHP ZipArchive,需確保文件系統編碼一致,或預先將文件名轉為 UTF-8。

進階:排除特定文件/目錄


$this->zip->read_dir($path, FALSE);
// 手動過濾:遍歷 $this->zip->get_zip() 不可行,需自行遞歸添加
$zip = new ZipArchive();
$zip->open($tmpFile, ZipArchive::CREATE);
$iterator = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($path));
foreach ($iterator as $file) {
    if ($file->isFile() && !preg_match('/\.(log|tmp)$/', $file->getFilename())) {
        $localName = substr($file->getPathname(), strlen($path)+1);
        $zip->addFile($file->getPathname(), $localName);
    }
}
$zip->close();

原生 ZipArchive 靈活性更高,CI 類庫僅適合簡單場景。

copyright © 萬盛學電腦網 all rights reserved