PHP ZipArchive 類別提供完整的 ZIP 壓縮檔操作功能。本文整理建立、讀取解壓、新增檔案、刪除檔案四大核心操作的最佳實踐。
zip 擴充套件(php_zip.dll / php-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";
}
?>
<?php
$zip = new ZipArchive;
if ($zip->open('archive.zip') === true) {
$zip->deleteName('unwanted_file.txt'); // 刪除檔案
$zip->deleteName('old_folder/'); // 刪除目錄(含內容)
$zip->close();
echo '刪除完成';
} else {
echo '開啟失敗';
}
?>
<?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 '開啟/建立失敗';
}
?>
<?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)。跨平台相容建議:
iconv('UTF-8', 'CP950', $filename) 轉碼(Windows 環境)ZipArchive::setOptions(ZipArchive::FL_ENC_UTF_8)(需 libzip 1.6+)| 常數 | 值 | 說明 |
|---|---|---|
| ZipArchive::ER_OK | 0 | 無錯誤 |
| ZipArchive::ER_MULTIDISK | 1 | 多磁碟 ZIP 不支援 |
| ZipArchive::ER_RENAME | 2 | 重新命名失敗 |
| ZipArchive::ER_CLOSE | 3 | 關閉失敗 |
| ZipArchive::ER_SEEK | 4 | Seek 錯誤 |
| ZipArchive::ER_READ | 5 | 讀取錯誤 |
| ZipArchive::ER_WRITE | 6 | 寫入錯誤 |
| ZipArchive::ER_CRC | 7 | CRC 校驗失敗 |
| ZipArchive::ER_ZIPCLOSED | 8 | ZIP 已關閉 |
| ZipArchive::ER_NOENT | 9 | 檔案不存在 |
| ZipArchive::ER_EXISTS | 10 | 檔案已存在 |
| ZipArchive::ER_OPEN | 11 | 無法開啟 |
| ZipArchive::ER_TMPOPEN | 12 | 暫存檔開啟失敗 |
| ZipArchive::ER_ZLIB | 13 | Zlib 錯誤 |
| ZipArchive::ER_MEMORY | 14 | 記憶體不足 |
| ZipArchive::ER_CHANGED | 15 | 內容已變更 |
| ZipArchive::ER_COMPNOTSUPP | 16 | 壓縮方法不支援 |
| ZipArchive::ER_EOF | 17 | 過早 EOF |
| ZipArchive::ER_INVAL | 18 | 無效參數 |
| ZipArchive::ER_NOZIP | 19 | 非 ZIP 檔案 |
| ZipArchive::ER_INTERNAL | 20 | 內部錯誤 |
| ZipArchive::ER_INCONS | 21 | 資料不一致 |
| ZipArchive::ER_REMOVE | 22 | 移除檔案失敗 |
| ZipArchive::ER_DELETED | 23 | 項目已刪除 |
ZipArchive 是 PHP 處理 ZIP 的標準工具,掌握 open、extractTo、addFile、deleteName、addFromString 五大核心方法,即可應付絕大多數壓縮檔操作需求。