PHP使用ZipArchive批量压缩下载教程

本文深入剖析了PHP中使用ZipArchive批量压缩文件并实现安全下载的五大核心痛点：权限校验缺失导致open()失败、中文路径与大文件处理不当、HTTP头发送前输出缓冲污染引发下载异常、临时ZIP文件未及时清理造成磁盘爆满，以及各环节缺乏可预期的健壮性保障；通过is_writable()预检、addFromString替代addFile()、ob_end_clean()强制清空缓冲、RFC 5987编码中文文件名、临时目录生成+立即unlink等实操方案，手把手教你避开线上高频踩坑，让每一次压缩下载都稳定可靠、用户零感知故障。

ZipArchive::open() 返回 false 是最常踩的坑

不是代码写错了，大概率是目录没权限或路径不存在。PHP 进程用户（比如 www-data 或 nginx）必须对目标压缩文件路径有写权限，且父目录存在。常见错误是直接写 new ZipArchive() 后调用 open('output.zip', ZipArchive::CREATE)，但当前工作目录不可写，或 output.zip 路径里有不存在的子目录。

实操建议：

• 用 is_writable(dirname($zipPath)) 提前校验写入位置，而不是靠 open() 的返回值“猜”原因
• 绝对路径比相对路径更可靠，可用 __DIR__ . '/downloads/archive_' . time() . '.zip'
• 如果 open() 返回 ZIPARCHIVE::ER_NOZIP（-1），说明文件被占用或磁盘满；返回 ZIPARCHIVE::ER_READ（-2）通常是权限问题

addFile() 无法添加大文件或中文路径文件

根本原因是 addFile() 只接受真实存在的本地文件路径，且不自动处理编码。Windows 下 PHP 默认用 ANSI 读取文件名，Linux 用 UTF-8，一旦源路径含中文，addFile() 就会静默失败（不报错，但压缩包里没有该文件）。

实操建议：

• 统一用 addFromString($filenameInZip, file_get_contents($realPath)) 替代 addFile()，绕过路径编码问题
• 对大文件（如 >50MB），避免一次性 file_get_contents() 占爆内存，改用 fopen() + fread() 分块读取再拼接字符串
• 注意 $filenameInZip 必须是 ZIP 内部路径格式（用 / 分隔，不能含 ../），否则解压时可能写到服务器任意位置

header() 发送失败导致下载乱码或断连

本质是输出缓冲没清理干净。只要在 header() 前有任何输出（包括空格、BOM、echo、警告信息），浏览器就收不到正确的 Content-Disposition，轻则文件名乱码，重则下载中断为零字节。

实操建议：

• 调用 ob_end_clean() 在 header() 前强制清空输出缓冲，比依赖 ob_start() 更稳妥
• 设置三个关键 header：Content-Type: application/zip、Content-Disposition: attachment; filename="archive.zip"、Content-Length: ' . filesize($zipPath)
• 中文文件名要用 RFC 5987 编码：把 filename*=UTF-8''archive%E4%B8%AD%E6%96%87.zip 放进 Content-Disposition，否则 IE/Edge 会显示问号

压缩后不删临时 ZIP 文件会撑爆磁盘

很多人只关注“能下”，忘了清理。每次生成新 ZIP 都写入磁盘，若并发高或忘记定时清理，几天就能占满空间。而且 ZIP 文件一旦开始下载，就不能被 unlink() 删除（Linux 下可删 inode，但 Windows 会报“文件正被使用”）。

实操建议：

• 下载完成后立即 unlink($zipPath) —— 必须放在 readfile($zipPath) 之后、脚本结束前
• 不要用 register_shutdown_function() 清理，它无法保证在下载流关闭后执行
• 更健壮的做法：生成 ZIP 到 sys_get_temp_dir()，下载完立刻删；若需审计留存，另存一份带时间戳的副本，主流程仍走临时目录

真正难的不是打包，是让每一步都可预期：权限是否到位、编码是否一致、缓冲是否干净、磁盘是否安全。漏掉其中一环，用户点下载就卡在“正在连接”。

本篇关于《PHP使用ZipArchive批量压缩下载教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！