萬盛學電腦網

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

PHP 操作 ZIP 壓縮檔完整指南:建立、讀取、新增、刪除

前言

PHP ZipArchive 類別提供完整的 ZIP 壓縮檔操作功能。本文整理建立、讀取解壓、新增檔案、刪除檔案四大核心操作的最佳實踐。

環境需求

  • PHP 安裝 zip 擴充套件(php_zip.dll / php-zip)
  • PHP 5.2+ 內建支援

核心操作範例

1. 解壓縮 ZIP 檔

<?php
$zipPath = 'example.zip';
$extractDir = 'extracted_files';

$zip = new ZipArchive;
$res = $zip->open($zipPath);
if ($res === true) {
    // 解壓全部
    $zip->extractTo($extractDir);
    // 或解壓指定檔案
    // $zip->extractTo($extractDir, ['file1.txt', 'images/photo.jpg']);
    $zip->close();
    echo "解壓成功至 $extractDir";
} else {
    echo "開啟失敗,錯誤碼: $res";
}
?>

2. 從 ZIP 中刪除檔案/目錄

<?php
$zip = new ZipArchive;
if ($zip->open('archive.zip') === true) {
    $zip->deleteName('unwanted_file.txt');      // 刪除檔案
    $zip->deleteName('old_folder/');            // 刪除目錄(含內容)
    $zip->close();
    echo '刪除完成';
} else {
    echo '開啟失敗';
}
?>

3. 向既有 ZIP 新增檔案

<?php
$zip = new ZipArchive;
// ZipArchive::CREATE 會在檔案不存在時建立新檔
if ($zip->open('archive.zip', ZipArchive::CREATE) === true) {
    $zip->addFile('new_document.pdf', 'documents/new_document.pdf'); // 可指定壓縮內路徑
    $zip->addFromString('readme.txt', '這是字串內容直接寫入'); // 從字串建立檔案
    $zip->close();
    echo '新增完成';
} else {
    echo '開啟/建立失敗';
}
?>

4. 建立新 ZIP 並加入多個檔案/目錄

<?php
function create_zip($sourceDir, $outputZip) {
    $zip = new ZipArchive;
    if ($zip->open($outputZip, ZipArchive::CREATE | ZipArchive::OVERWRITE) !== true) {
        throw new Exception("無法建立 $outputZip");
    }

    $iterator = new RecursiveIteratorIterator(
        new RecursiveDirectoryIterator($sourceDir, FilesystemIterator::SKIP_DOTS),
        RecursiveIteratorIterator::SELF_FIRST
    );

    foreach ($iterator as $item) {
        $path = $item->getPathname();
        $relativePath = substr($path, strlen($sourceDir) + 1);

        if ($item->isDir()) {
            $zip->addEmptyDir($relativePath);
        } else {
            $zip->addFile($path, $relativePath);
        }
    }
    $zip->close();
    return true;
}

// 使用
create_zip('my_project', 'my_project_backup.zip');
?>

中文檔名編碼問題

ZIP 標準早期不支援 Unicode,PHP ZipArchive 使用系統預設編碼(Windows 為 CP950/Big5,Linux 為 UTF-8)。跨平台相容建議:

  • 檔名盡量使用 ASCII 英數字
  • 或使用 iconv('UTF-8', 'CP950', $filename) 轉碼(Windows 環境)
  • PHP 8.0+ 可嘗試 ZipArchive::setOptions(ZipArchive::FL_ENC_UTF_8)(需 libzip 1.6+)

錯誤碼對照表

常數值說明
ZipArchive::ER_OK0無錯誤
ZipArchive::ER_MULTIDISK1多磁碟 ZIP 不支援
ZipArchive::ER_RENAME2重新命名失敗
ZipArchive::ER_CLOSE3關閉失敗
ZipArchive::ER_SEEK4Seek 錯誤
ZipArchive::ER_READ5讀取錯誤
ZipArchive::ER_WRITE6寫入錯誤
ZipArchive::ER_CRC7CRC 校驗失敗
ZipArchive::ER_ZIPCLOSED8ZIP 已關閉
ZipArchive::ER_NOENT9檔案不存在
ZipArchive::ER_EXISTS10檔案已存在
ZipArchive::ER_OPEN11無法開啟
ZipArchive::ER_TMPOPEN12暫存檔開啟失敗
ZipArchive::ER_ZLIB13Zlib 錯誤
ZipArchive::ER_MEMORY14記憶體不足
ZipArchive::ER_CHANGED15內容已變更
ZipArchive::ER_COMPNOTSUPP16壓縮方法不支援
ZipArchive::ER_EOF17過早 EOF
ZipArchive::ER_INVAL18無效參數
ZipArchive::ER_NOZIP19非 ZIP 檔案
ZipArchive::ER_INTERNAL20內部錯誤
ZipArchive::ER_INCONS21資料不一致
ZipArchive::ER_REMOVE22移除檔案失敗
ZipArchive::ER_DELETED23項目已刪除

總結

ZipArchive 是 PHP 處理 ZIP 的標準工具,掌握 open、extractTo、addFile、deleteName、addFromString 五大核心方法,即可應付絕大多數壓縮檔操作需求。

copyright © 萬盛學電腦網 all rights reserved