PHP压缩解压缩代码

wen PHP项目 2026-08-11 3

本文目录导读：

PHP压缩解压缩代码

📖 目录导读
为什么PHP开发者需要掌握压缩解压缩？
核心工具：ZipArchive 类深度详解
进阶利器：PharData 处理 tar 与 phar 格式
性能与安全：处理大文件与防御Zip炸弹
常见问题 FAQ（快速问答）

PHP压缩解压缩实战指南：ZipArchive与 PharData 全解析**

📖 目录导读

为什么PHP开发者需要掌握压缩解压缩？
核心工具：ZipArchive 类深度详解
- 创建与添加文件
- 解压与提取
- 高级功能（密码、流处理）
进阶利器：PharData 处理 tar 与 phar 格式
性能与安全：处理大文件与防御Zip炸弹
常见问题 FAQ（快速问答）

为什么PHP开发者需要掌握压缩解压缩？

在现代Web开发中,无论是打包日志、备份数据库、导出批量图片，还是接收第三方API的压缩包，PHP压缩解压缩代码都是高频刚需，使用内置扩展 ZipArchive 和 PharData，你可以避免调用系统Shell（如 exec("zip ...")）带来的安全风险，并实现跨平台（Windows/Linux）的稳定运行。

核心优势：

节省带宽：前端下载压缩包可减少HTTP传输流量。
自动化：定时任务中自动打包日志文件归档。
互操作性：与主流系统（Linux zip 命令、Windows 右键压缩）完全兼容。

核心工具：ZipArchive 类深度详解

ZipArchive 是PHP官方推荐的Zip格式处理类，支持创建、读取、修改和加密。确保你的php.ini中已启用extension=zip。

1 创建并添加文件（打包下载场景）

<?php
$zip = new ZipArchive();
$zipName = tempnam(sys_get_temp_dir(), 'backup_') . '.zip'; // 临时文件
if ($zip->open($zipName, ZipArchive::CREATE | ZipArchive::OVERWRITE) === TRUE) {
    // 添加单个字符串内容为文件
    $zip->addFromString('readme.txt', "这是直接写入的文件内容\n");
    // 添加本地磁盘文件
    $zip->addFile('/path/to/your/source.pdf', 'docs/source.pdf');
    // 添加整个目录（递归）
    $dir = '/path/to/folder';
    $files = new RecursiveIteratorIterator(
        new RecursiveDirectoryIterator($dir),
        RecursiveIteratorIterator::LEAVES_ONLY
    );
    foreach ($files as $file) {
        if (!$file->isDir()) {
            $filePath = $file->getRealPath();
            $relativePath = 'backup/' . substr($filePath, strlen($dir) + 1);
            $zip->addFile($filePath, $relativePath);
        }
    }
    $zip->close();
    // 强制下载
    header('Content-Type: application/zip');
    header('Content-Disposition: attachment; filename="backup.zip"');
    header('Content-Length: ' . filesize($zipName));
    readfile($zipName);
    unlink($zipName); // 删除临时文件
    exit;
} else {
    die('无法创建Zip文件');
}
?>

2 解压与提取（上传导入场景）

<?php
$zip = new ZipArchive();
$res = $zip->open('uploaded_package.zip');
if ($res === TRUE) {
    // 解压到指定目录（确保目录可写）
    $zip->extractTo('/var/www/uploads/extracted/');
    $zip->close();
    echo "解压成功，共 " . $zip->numFiles . " 个条目\n";
    // 部分提取：仅解压特定正则匹配的文件
    $zip->open('uploaded_package.zip');
    for ($i = 0; $i < $zip->numFiles; $i++) {
        $stat = $zip->statIndex($i);
        if (preg_match('/\.(jpg|png)$/i', $stat['name'])) {
            $zip->extractTo('/img/', $stat['name']); // 按需提取图片
        }
    }
} else {
    echo '解压失败，错误码：' . $res; // 返回错误码如 11（文件不存在）
}
$zip->close();
?>

3 高级技巧：密码与流处理

设置密码：$zip->setPassword('secret'); 配合 addFile 后使用 $zip->setEncryptionName($filename, ZipArchive::EM_AES_256);
流式下载大文件：使用 ZipStream 方案（需Composer包 maennchen/zipstream-php）避免内存溢出，对于超大文件，不要一次性addFile，改用 addFile 的流式版本。

进阶利器：PharData 处理 tar 与 phar 格式

如果对方系统是Linux/Unix环境，tar.gz 格式更常见（如Composer依赖包）。PharData 类可以优雅地处理 .tar、.tar.gz 和 .phar。

<?php
// 创建 tar.gz 包
$phar = new PharData('myarchive.tar');
$phar->addFile('/path/to/config.php', 'config.php');
$phar->addDirectory('/path/to/views');
// 压缩成 gz 格式（生成 myarchive.tar.gz）
$phar->compress(Phar::GZ);
// 解压 tar.gz
$phar2 = new PharData('myarchive.tar.gz');
$phar2->decompress(); // 生成 myarchive.tar
$phar2->extractTo('/output/dir');
?>

注意：PharData 不适用于 .zip 加密文件（密码），且对于 .phar 文件需额外注意 stub 和 alias 的安全校验。

性能与安全：处理大文件与防御Zip炸弹

1 性能瓶颈优化

内存限制：处理500MB以上文件时，增加 ini_set('memory_limit', '512M')。
缓冲写入：使用 addFile 时，PHP内部会流式读取，避免整个文件载入内存。
禁用压缩：对于已压缩的图片（JPG/PNG）和视频，设置 ZipArchive::CM_STORE 方法（仅存储，不压缩），节省CPU。

2 安全红线（必看）

Zip Slip 攻击：解压时务必校验文件路径，防止 ../../evil.php 逃出目标目录。通用解法：解压前遍历条目，使用 realpath() 检查绝对路径是否包含在目标目录内。
Zip 炸弹：压缩率极高的文件（如 10GB 文本压缩成 10MB）。防御策略：检查解压后总大小（通过 statIndex 累计 size 字段），设定上限（如 200MB），超出则终止。
杀毒扫描：对上传的压缩包，建议先用ClamAV扫描再解压。

常见问题 FAQ（快速问答）

Q1：PHP 5.6 有没有 ZipArchive？没有怎么办？

A：PHP 5.6 自带 ZipArchive（需编译启用 --enable-zip），若缺失则使用 PclZip 库（兼容性极佳），推荐升级至 PHP 8.x，性能和安全有极大提升。

Q2：$zip->open() 返回 11 或 21 错误代码是什么？

11 表示文件不存在（Couldn't open）。

21 表示文件已存在且未设置覆盖（ZipArchive::OVERWRITE 未开启）。排查时先确认文件路径权限和常量使用。

Q3：压缩中文文件名时出现乱码怎么办？

Zip标准使用 CP437 编码，中文需要转码，PHP 8.2+ 支持 ZipArchive::setExternalAttributes，或者使用 iconv('UTF-8', 'GBK//IGNORE', $fileName) 转换后再添加，解压时反向转回。

Q4：能否直接压缩网络URL文件而不下载到本地？

可以,使用 file_get_contents 获取流，addFromString 添加，但会占用内存，最佳实践是设置 stream 上下文，用 fopen 打开远程流，配合 ZipStream 库实现零存储下载。

Q5：如何处理解压后的超长路径（Windows 255字符限制）？

Windows 解压长路径会失败，建议在 extractTo 前启用 Windows 长路径支持（注册表 LongPathsEnabled），或代码中检查 strlen($fullPath) > 200 时自动缩短目录名。

掌握 ZipArchive 和 PharData 是每个PHP开发者处理文件系统必备的技能，务必在开发环境（沙箱）测试解压路径穿越和文件大小限制，为你的应用加上最后一道安全锁，如果你在处理特定格式（如RAR）时遇到困难，欢迎在评论区留下你的问题，我会抽空解答。