PHP使用ZipArchive前需检查扩展启用、路径编码、大文件处理及中文乱码问题：Linux用php -m | grep zip，Windows确认php.ini中extension=zip；路径含中文或空格时优先用addFromString()；大文件应分块写入或调用系统zip命令；Windows解压乱码需转CP936编码或换第三方库。
PHP用ZipArchive打包文件前必须检查扩展是否启用
很多报错直接卡在Class 'ZipArchive' not found，不是代码写错了，是服务器根本没装或没启zip扩展。Linux下用php -m | grep zip确认；Windows看php.ini里有没有extension=zip（注意不是php_zip.dll，新版PHP已统一为zip）。Apache重启后还得用phpinfo()页面二次验证——光改配置不生效是常见疏漏。
归档路径含中文或空格时addFile()会静默失败
ZipArchive::addFile()对非ASCII字符和空格极其敏感，尤其在Windows上容易跳过文件却不报错。稳妥做法是：先用realpath()转绝对路径，再用mb_convert_encoding()转为UTF-8（如果原始文件名是GBK），最后用urlencode()编码路径再解码回本地编码——但更简单的是统一用addFromString()绕过路径问题：
$zip->addFromString('data_2023.log', file_get_contents($src_path));归档大量小文件时，这个方式比addFile()还快，因为省去了反复打开文件的系统调用。
大文件归档中途崩溃？别用addFile()直接塞，分块流式写入
单个超100MB的文件用addFile()容易触发内存溢出或超时，ZipArchive本身不支持流式添加。可行方案是：先用fopen()读取源文件，每次fread()64KB，拼成字符串后用addFromString()追加（注意设置足够大的memory_limit）；或者更稳的做法——改用系统命令：
立即学习“PHP免费学习笔记（深入）”；
- Linux下用
exec("zip -j {$zipPath} {$srcDir}/* 2>&1", $output, $return)，加-j参数忽略目录结构 - 确保
escapeshellarg()包裹所有路径变量，防止命令注入 - 用
set_time_limit(0)避免超时，但得配合ignore_user_abort(true)防用户关页面中断
生成的ZIP在Windows上解压乱码？根源在文件名编码
PHP的ZipArchive默认按CP437编码存文件名，而Windows资源管理器认GBK/UTF-8，导致中文名显示为“涓枃”. 解决方法只有两个：
- 强制用
iconv("UTF-8", "CP936", $filename)转码后再传给addFile()（仅限简体中文环境） - 彻底放弃
ZipArchive，改用chrisboulton/php-zip等第三方库，它支持setFilenameEncoding('UTF-8')
没有银弹——要么妥协兼容性，要么引入额外依赖。生产环境建议加个file_exists()校验归档后文件大小，防止空包入库。
