ZipArchive::open() 返回 false 时需检查路径存在且可读、目标目录可写、Windows 路径规范，并用 getStatusString()（PHP ≥ 8.0）或 status 码查错。
ZipArchive::open() 返回 false 怎么办
ZipArchive::open() 失败不报具体错误，只返回 false，这是最常卡住人的第一步。根本原因通常是路径不可写、文件不存在、权限不足，或 ZIP 文件本身损坏。
- 检查 ZIP 文件路径是否真实存在且 PHP 进程有读取权限：
file_exists($path)和is_readable($path)必须都为true - 解压目标目录必须存在且可写（
is_writable($dir)），ZipArchive不会自动创建父级目录 - Windows 下注意反斜杠转义问题，统一用正斜杠或
realpath()规范路径 - 用
$zip->getStatusString()获取最后一次操作的错误描述（PHP ≥ 8.0），旧版本只能靠$zip->status查表比对
$zip = new ZipArchive();
$res = $zip->open('archive.zip');
if ($res !== true) {
echo "Open failed: " . $zip->getStatusString(); // PHP 8.0+
// 或查状态码：var_dump($zip->status);
}
解压时文件名乱码（尤其是中文）
PHP 原生 ZipArchive 读取 ZIP 文件时，默认按 CP437 编码解析文件名，而国内常用 UTF-8 打包的 ZIP 就会显示为乱码——这不是解压失败，是名字没“认对”。
- 没有内置编码转换接口，必须手动重命名：
ZipArchive::renameName()或解压后用mb_convert_encoding()修正 - 更稳妥的做法：解压到临时目录，再遍历
scandir()获取文件列表，对每个文件名做mb_convert_encoding($name, 'UTF-8', 'CP437') - 注意：Windows 自带压缩工具打的 ZIP 通常用 GBK，不是 CP437，得试
'GBK'；Mac 默认是 UTF-8，一般没问题
打包时 addFile() 和 addFromString() 的选择
要往 ZIP 里加内容，两个方法看似都能用，但行为差异直接影响结果：
-
addFile()直接读取磁盘文件，路径必须真实存在，且 PHP 有读取权限；它保留原始文件的修改时间（stat($file)['mtime']） -
addFromString()把字符串当文件内容写入，适合动态生成的内容（如日志片段、API 返回体），但无法设置修改时间，且文件名必须手动指定，不能含../路径穿越字符 - 二者都不支持流式写入，大文件会吃内存；超过几十 MB 建议改用
exec('zip -r ...')或分块处理
$zip->addFile('/tmp/report.txt', 'output/report.txt'); // 磁盘文件
$zip->addFromString('Hello 世界', 'readme.txt'); // 字符串内容
解压 zip 后权限丢失或执行位被清空
Linux 下用 ZipArchive 解压，所有文件默认权限是 0644（即使原 ZIP 里标记了 0755），执行脚本或可执行二进制会直接失效。
立即学习“PHP免费学习笔记（深入）”；
-
ZipArchive不保留 Unix 权限位，PHP 层无配置项可开启 - 解压后需手动
chmod，例如遍历解压目录，对.sh、.bin后缀文件补0755 - 更彻底的方案：改用系统
unzip -X（保留扩展属性）命令，配合exec()调用，但需确认服务器允许并启用该命令
乱码、权限、路径、状态判断——这四个点没踩过至少两个，基本算没真正用过 ZipArchive。它很轻，但不“傻瓜”。
