ziparchive::open()返回false主因是目录无写权限或路径不存在，需检查php进程用户（如www-data）对目标路径的写权限及父目录存在性，并用is_writable()提前校验。
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免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
