ZipArchive流式压缩需避免内存溢出和空文件问题，必须指定创建标志、校验文件可读性、规范路径处理；ThinkPHP中边压边下载需清空输出缓冲、正确设置响应头并直接readfile；大文件优先落地再addFile；Windows中文名需GBK转码兼容。
ZipArchive流式压缩失败：内存溢出或空文件
直接用 ZipArchive::addFile() 往内存里塞几百个大文件，PHP进程很容易被 kill，或者生成的 ZIP 打不开。根本原因是没走流式，ZipArchive 默认把整个压缩包缓存在内存里，直到 close() 才写盘——但你根本等不到那一刻。
- 必须在
open()时指定ZIPARCHIVE::CREATE | ZIPARCHIVE::OVERWRITE，否则部分系统（尤其是 Windows + IIS）会因权限或临时路径问题静默失败 - 每个
addFile()前先用file_exists()和is_readable()检查，否则漏掉一个文件，ZipArchive不报错、不跳过、也不提示，最后 ZIP 少内容还校验通过 - 避免在循环里反复调用
addFile($path, $localname)传绝对路径当$localname，会导致 ZIP 内出现完整磁盘路径（如C:/www/app/runtime/logs/2024-06.log），用basename($path)或自定义子目录前缀更安全
ThinkPHP中边压边下载：header和输出顺序不能错
HTTP 下载靠的是响应头 + 原始二进制输出，一旦中间有 echo、var_dump、甚至 ThinkPHP 的日志自动 flush，就会提前触发 HTTP body，后面再设 header 就无效，浏览器收到乱码或 0 字节 ZIP。
- 下载前必须调用
ob_end_clean()清掉所有已缓冲输出（包括框架可能打的日志、调试信息） -
header('Content-Type: application/zip')和header('Content-Disposition: attachment; filename="export.zip"')必须在ZipArchive::close()之后、readfile()之前发，且不能有任何输出干扰 - 别用
return download(...)这类 ThinkPHP 封装——它内部可能做额外处理；直接用readfile($zipPath)然后exit最稳妥 - 临时 ZIP 文件建议放在
runtime/目录下，用tempnam(sys_get_temp_dir(), 'tp_zip_')生成唯一名，避免并发冲突
大文件场景下 addFromString 替代 addFile 的取舍
当要压缩的内容来自数据库 BLOB、API 响应或加密解密后的内存数据，没法落地成临时文件时，addFromString() 是唯一选择，但它会把整块内容读进内存再压——100MB 的内容 = PHP 进程多占至少 150MB 内存。
- 超过 5MB 的单文件内容，优先考虑先写临时文件，再
addFile()；用完立即unlink() -
addFromString($filename, $content)中的$filename同样要控制路径层级，不要含../或绝对路径，否则解压时可能覆盖服务器文件（虽现代 ZipArchive 已默认过滤，但旧版本 PHP 存风险） - 如果内容需动态生成（比如导出带时间戳的 CSV），用
fopen('php://memory', 'r+b')写入再stream_get_contents()拿字符串，比拼接大字符串更省内存
Windows服务器上中文文件名乱码的修复点
不是 ZipArchive 本身的问题，是 Windows 解压工具（包括资源管理器）默认用 GBK 解码 ZIP 中的 UTF-8 文件名，结果全变问号。PHP 侧能做的有限，但有几个关键动作能覆盖 90% 场景：
立即学习“PHP免费学习笔记（深入）”；
- 确保 PHP 文件保存为 UTF-8 无 BOM，且
mb_internal_encoding('UTF-8')已设（ThinkPHP 通常已做） - 对中文文件名，用
iconv('UTF-8', 'GBK', $filename)转码后再传给addFile()或addFromString()——这是最兼容的做法，虽然严格说不符合 ZIP 规范，但 WinRAR / 7-Zip / Windows 自带解压都认 - 不要依赖
ZipArchive::setArchiveComment()或注释字段来“补救”文件名，解压工具基本不读这个 - 如果必须跨平台保真，改用
chilkat或pecl zip扩展，原生支持 UTF-8 文件名标志位，但部署成本高
真正麻烦的不是怎么压，而是压完发现用户双击打不开、解压后文件名是乱码、或者手机端微信/QQ 里点开直接报错——这些细节没卡准，前面所有逻辑都白写。
