ZipArchive打包文件夹为空，因未递归遍历或路径错误；需用RecursiveDirectoryIterator遍历、realpath()规范路径、addFile()传入正确相对路径，并检查open()/close()返回值。
PHP用ZipArchive类打包文件夹时，为什么生成的ZIP是空的？
常见原因是没递归读取子目录，或者路径处理错误导致 addFile() 添加失败。ZipArchive 默认不自动遍历目录，必须手动遍历所有文件并逐个添加，且传入的路径必须是真实存在的绝对路径或相对路径（以当前工作目录为基准）。
- 确保用
realpath()转换源文件夹路径，避免符号链接或相对路径歧义 - 遍历时跳过
.和..，也跳过无法读取的文件（如权限不足的子目录） -
addFile()的第二个参数（存档内路径）不能以/开头，否则部分解压工具会忽略；建议统一用str_replace($source . '/', '', $file)构造归档路径 - 调用
close()前务必检查返回值：若为false，说明写入失败（如磁盘满、无写权限）
如何让ZipArchive正确保留文件夹结构？
关键在 addFile() 的第二个参数——它决定该文件在 ZIP 包内的路径位置。如果只传文件名，所有文件都会被扁平化到根目录；要还原层级，必须显式构造带子目录的路径字符串。
- 用
RecursiveIteratorIterator+RecursiveDirectoryIterator遍历更安全，自动跳过不可读项 - 对每个
$file，用$file->getRealPath()获取真实路径，再用substr($file->getRealPath(), strlen($source) + 1)截出相对路径 - 若目标 ZIP 中需以
myproject/为根目录，可在截出的相对路径前统一加前缀，如'myproject/' . $relPath - 注意：空目录不会被自动创建，需手动调用
addEmptyDir()（PHP 7.2+），否则解压后缺失空文件夹
遇到“ZipArchive::addFile(): Invalid or uninitialized Zip object”怎么办？
这表示 ZipArchive 实例未成功打开 ZIP 文件，常见于 open() 返回非 0 值却未检查。错误码 ZIPARCHIVE::ER_OPEN（即 -1）通常意味着目标路径不可写，或父目录不存在。
- 先确保 ZIP 目标路径的父目录存在且可写：
is_writable(dirname($zipFile)) -
open()必须检查返回值：if ($zip->open($zipFile, ZipArchive::CREATE) !== TRUE) { /* 处理错误 */ } - 不要复用已关闭或未初始化的
$zip对象；每次打包建议新建实例 - Windows 下注意路径分隔符，
str_replace('\', '/', $path)可避免部分 ZIP 工具识别异常
大文件夹压缩时内存溢出或超时怎么办？
默认情况下，PHP 会把整个 ZIP 缓存在内存中直到 close()，但实际 ZipArchive 是流式写入磁盘的，内存占用主要来自 PHP 自身的文件遍历和字符串操作。真正瓶颈常是执行时间或单次脚本内存限制。
立即学习“PHP免费学习笔记（深入）”；
- 调用
set_time_limit(0)解除执行时间限制（CLI 环境下更必要） - 避免一次性
glob()或scandir()整个深层目录，改用RecursiveDirectoryIterator迭代器，边遍历边添加，减少内存驻留 - 对超大文件（如 >100MB），考虑跳过或单独提示，避免
addFile()因超时失败 - 生产环境建议异步处理：先生成任务队列，由 CLI 脚本执行压缩，再通过 AJAX 轮询状态
有些边缘情况容易被忽略：比如源目录含中文路径时，addFile() 在旧版 libzip 下可能乱码；此时需确认 PHP 编译时 libzip 版本 ≥ 1.6.0，并确保系统 locale 支持 UTF-8。另外，addFromString() 无法替代 addFile() 处理大文件，它会把内容全载入内存。
