ziparchive 是 php 原生压缩单个文件最稳妥方案，需启用 zip 扩展、open() 成功后 addfile() 添加、close() 关闭；多文件需手动遍历；中文名建议用 7-zip 解压；大文件应异步处理。
用 ZipArchive 类压缩单个文件最稳妥
PHP 原生支持 ZIP 压缩，ZipArchive 是唯一推荐的方案。别碰 exec('zip') 或第三方库——前者依赖系统命令且不安全，后者徒增维护负担。
关键点：必须确保 PHP 编译时启用了 zip 扩展（检查 phpinfo() 中是否有 Zip support => enabled）；Windows 用户注意扩展名是 php_zip.dll，Linux 下通常是 zip.so。
实操建议：
- 实例化后先调用
$zip->open($filename, \ZipArchive::CREATE)，返回值为 0 才代表成功，非零需查ZipArchive::ER_*错误码 - 添加文件用
$zip->addFile($real_path, $archive_name)，第二个参数决定压缩包内路径，可含子目录（如'logs/app.log'） - 务必调用
$zip->close()，否则生成的 ZIP 文件可能损坏或为空
压缩多个文件或目录要手动遍历
ZipArchive 没有内置递归添加目录的功能，必须自己写循环。常见错误是直接传入目录路径给 addFile()，结果静默失败。
使用场景：打包日志目录、导出用户上传的附件集合。
实操建议：
- 用
scandir()或RecursiveIteratorIterator + RecursiveDirectoryIterator遍历源目录，跳过.和.. - 对每个文件调用
is_file()判断，避免把空目录或符号链接塞进去 - 计算相对路径：若源是
/var/www/uploads/，当前文件是/var/www/uploads/a/b.txt，则存档名为a/b.txt（用str_replace($base_dir, '', $full_path)处理） - 注意路径分隔符统一用
/，Windows 下\会导致 ZIP 内路径异常
中文文件名乱码问题怎么解
ZIP 格式本身不强制编码，但 Windows 解压工具默认按 GBK 解码，而 PHP addFile() 写入的是 UTF-8 字节流，导致中文名显示为乱码。
没有完美解法，兼容性排序：Linux/macOS 解压工具（如 unzip）通常能自动识别 UTF-8；Windows 资源管理器原生不支持，需用 Bandizip、7-Zip 等工具打开。
实操建议：
- 不建议在 PHP 层做 GBK 编码转换（
iconv('UTF-8', 'GBK', $name)），因为会破坏原始文件名语义，且 macOS/Linux 下反而显示异常 - 如果必须强兼容 Windows 资源管理器，改用
addFromString()替代addFile()，手动读取文件内容再写入，并将文件名转 GBK（仅限简体中文环境） - 更实际的做法：前端提示用户“请用 7-Zip 解压以正确显示中文名”
大文件压缩内存和超时怎么控
直接 addFile() 不会把整个文件读进内存，但 addFromString() 会。真正吃内存的是 ZIP 的压缩缓冲区和 PHP 自身的内存限制。
性能影响：压缩 100MB 文件时，memory_limit 至少设为 256M；max_execution_time 建议调高到 300 秒以上，尤其在低配服务器上。
实操建议：
- 用
set_time_limit(0)临时禁用超时，但线上环境应结合队列异步处理大文件 - 监控
memory_get_usage()，在循环添加前预估总大小，超过阈值就拆分成多个 ZIP - 避免在 Web 请求中压缩 >500MB 的文件——改用 CLI 模式执行，或由后台任务完成
真正麻烦的不是代码几行，而是路径处理、编码兼容、资源控制这三块。特别是生产环境里，用户上传的文件路径千奇百怪，realpath() 和 is_readable() 检查不能省；而 ZIP 包一旦生成就无法增量修改，所有逻辑必须在 close() 前验证完毕。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
