ZipArchive::open()大文件打包失败主因是未校验返回值、路径权限缺失及内存溢出。须用$zip->open($file, ZipArchive::CREATE|OVERWRITE)判TRUE，逐文件检查file_exists()和is_readable()，大文件禁用addFromString()防OOM，优先addFile()并做路径白名单校验。
ZipArchive::open() 为什么总在大文件打包时卡住或失败
不是 ZipArchive 本身慢，而是默认行为没做资源隔离：open() 后若不检查返回值，addFile() 遇到权限不足、路径不存在或磁盘满，会静默跳过，最后生成空包或缺文件；更隐蔽的是，PHP 进程内存被撑爆后直接被 OOM killer 杀掉，连错误都来不及抛。
实操建议：
- 必须用
$res = $zip->open($file, ZipArchive::CREATE | ZipArchive::OVERWRITE)并判断$res === TRUE，非 0 值（如ZIPARCHIVE::ER_NOZIP）要立刻中止 - 对每个待添加文件，先跑
file_exists($path) && is_readable($path)，别信相对路径——Web 请求路径 ≠ CLI 执行路径 - 大文件（>50MB）禁用
addFile()，改用临时文件 +addFromString(file_get_contents($tmp))仅限小文件；否则直接 OOM
addFile() 和 addFromString() 在批量场景下的真实开销差异
addFile() 是零拷贝调用系统底层 read()，但受限于 PHP 的单线程模型，它仍是同步阻塞；addFromString() 把整个内容 load 进内存再传给 ZipArchive，适合动态生成的小数据（如 JSON、PDF 内存流），但对大文件等于自建内存炸弹。
常见错误现象：循环里反复 file_get_contents($big_file) → 内存持续上涨 → 脚本崩溃。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
- 纯磁盘文件优先用
addFile()，它是 ZipArchive 最高效路径 - 需要重命名或扁平化目录结构（比如去掉
/var/www/uploads/前缀），用$zip->addFile($realpath, basename($realpath))，别等加完再renameName()—— 那是事后补救，不可靠 - 真要处理动态大内容（如导出百万行 CSV），先写临时文件，再
addFile($tmp_csv)，最后unlink($tmp_csv)
压缩级别和方法设置对 CPU 与体积的实际影响
默认压缩是 ZipArchive::COMPRESSION_DEFLATE + 级别 6，够用但非最优。设成 ZipArchive::COMPRESSION_LEVEL_9 会让 CPU 时间翻倍，体积只减 3%～5%，而设为 0（无压缩）几乎不耗 CPU，但 ZIP 体积和源文件一致。
性能/兼容性影响：
- Web 下载场景：用户更在意「秒出包」而非「省几 MB」，推荐
setCompressionLevel(3) - 归档长期保存：用
setCompression(ZipArchive::COMPRESSION_DEFLATE, ZipArchive::COMPRESSION_LEVEL_6)，平衡体积与解压兼容性（CM_BZIP2在 Windows 解压工具里支持差） - 加密需求：ZipArchive 不原生支持密码，
setEncryptionMethod()仅限 PHP 7.4+ 且需 libzip ≥ 1.5.0，生产环境慎用；稳妥方案是 exec('zip -P pwd file.zip ...')，但得确认shell_exec未被禁用
解压时路径遍历和中文名乱码这两个坑怎么绕开
解压环节的 extractTo() 不校验路径，../../../etc/passwd 这类恶意文件名能直接写到系统关键位置；中文名乱码则源于 ZIP 规范无编码强制约定，PHP 写入用 UTF-8 字节，Windows 资源管理器默认按 CP437 或 GBK 解析。
实操建议：
- 解压前必须做路径白名单校验：
$realTarget = realpath($dest . '/' . $name); if (strpos($realTarget, realpath($dest)) !== 0) continue; - 中文文件名统一用
addFromString(iconv('UTF-8', 'GBK//IGNORE', $zh_name), $content)，前提是目标用户基本是 Windows + 国产解压软件；否则就告诉用户「请用 7-Zip 打开」，别在服务端硬转码 - 最省事方案：所有归档内文件名强制英文（
md5($original_name) . '.pdf'），另附manifest.json记录原始名映射，解压后由前端或脚本还原
