PHP中用ZipArchive打包多文件再下载最稳妥：必须先打包成ZIP再统一响应，不可多次输出Content-Disposition；需用绝对路径、校验文件存在性、清空输出缓冲、设置正确响应头（含filename*=UTF-8''编码），大文件优先addFile()避免内存溢出。
PHP中用ZipArchive打包多文件再下载最稳妥
直接输出多个Content-Disposition: attachment响应头是无效的——浏览器只认一个下载动作。必须把文件先打包，再统一响应。PHP内置的ZipArchive类是最轻量、无需额外扩展（PHP 7.4+ 默认启用）且可控性强的选择。
常见错误是边压缩边输出流，导致ZipArchive::close()失败或下载文件损坏；也有人试图用readfile()循环输出多个文件，结果只有第一个生效。
- 确保
zip扩展已启用：extension=zip在php.ini中未被注释 - 所有待打包文件路径必须是绝对路径，相对路径容易因
chdir()或CLI/web上下文差异出错 - 避免在
ZipArchive::addFile()时传入空内容或不存在的路径，否则静默跳过，但压缩包可能不完整 - 打包前用
clearstatcache()防止因文件系统缓存误判文件存在性
如何设置正确的HTTP响应头防止浏览器乱码或打开失败
下载中文文件名或含空格的文件名时，仅设Content-Disposition: attachment; filename="xxx.zip"会导致乱码或截断。必须用filename*=UTF-8''xxx.zip格式，并确保Content-Type为application/zip，同时禁用输出缓冲。
- 调用
ob_end_clean()清除所有已有输出，否则ZIP二进制流开头混入空格或HTML会损坏文件 - 用
header('Content-Type: application/zip')而非application/octet-stream，更明确语义 - 文件名编码：对原始文件名做
rawurlencode()，再拼入filename*=UTF-8''{encoded}，例如header('Content-Disposition: attachment; filename="archive.zip"; filename*=UTF-8\'\'' . rawurlencode('批量下载.zip') . ''); - 加上
header('Content-Transfer-Encoding: binary')和header('Expires: 0')减少代理或CDN缓存干扰
内存不足时怎么安全处理大文件批量打包
一次性把几百MB文件读入内存再写入ZIP，极易触发Fatal error: Allowed memory size exhausted。关键不是“增大memory_limit”，而是让ZipArchive直接从磁盘读取，不经过PHP内存中转。
立即学习“PHP免费学习笔记（深入）”；
-
ZipArchive::addFile($realpath, $localname)中的$realpath必须指向真实文件路径，它内部用C层直接mmap或read，不走PHP内存 - 避免用
ZipArchive::addFromString()加载大文件内容，那是把整个文件读进内存再塞进去 - 若需动态生成小文件（如CSV），再用
addFromString()；大文件一律addFile() - 打包完成后立即
unset($zip)并调用gc_collect_cycles()，加快资源释放
为什么不要用exec('zip')调用系统命令
虽然exec('zip -r archive.zip file1.txt file2.txt')看起来简单，但实际线上环境问题极多：权限限制（web用户通常无权执行shell）、路径空格/特殊字符需手动转义、错误输出难捕获、无法控制压缩级别、Windows服务器根本不可用。
-
ZipArchive跨平台一致，Linux/macOS/Windows行为完全相同 - 错误可捕获：
if ($zip->open($zipFile) !== TRUE) { die('Zip open failed: ' . $zip->getStatusString()); } - 支持设置压缩方法：
$zip->setCompressionIndex($index, ZipArchive::CM_DEFLATE)，平衡速度与体积 - 若真要调用外部命令，至少用
escapeshellarg()包裹每个路径，且必须检查proc_open()返回值，但没必要
最易被忽略的一点：打包前没检查磁盘空间。当临时目录（sys_get_temp_dir()）只剩几十MB，而你要打500MB的包，ZipArchive::close()会静默失败或返回ZIPARCHIVE::ER_NOZIP。上线前务必加一句disk_free_space(sys_get_temp_dir()) > $estimated_total_size * 1.2校验。
