ZipArchive::extractTo()无法解压带密码ZIP文件，因PHP原生ZipArchive完全不支持密码解密；可行方案是调用系统命令如7z x -p密码解压，需确保命令可用、权限充足且密码安全转义。
ZipArchive::extractTo() 为什么解压不了带密码的 ZIP 文件
PHP 原生 ZipArchive 类**完全不支持密码保护 ZIP 的解压**，这是它最常被误用的地方。调用 extractTo() 处理加密 ZIP 时不会报错，但解压出来的文件内容是空的、损坏的，或直接跳过加密条目——ZipArchive::getStatusString() 也返回不到有效错误信息。
根本原因：ZIP 规范中密码保护（传统 PKZIP 加密）是应用层行为，而 ZipArchive 底层依赖 libzip，而默认编译的 libzip 不启用 LIBZIP_ENABLE_ZIPCRYPTO 或 LIBZIP_ENABLE_OPENSSL，更不处理密码校验逻辑。
- 别试
setPassword()—— 这个方法在 PHP 8.2+ 才加入，且仅对「写入」操作生效（如添加文件时设密码），对「读取/解压」无效 - 别依赖
isEncrypted()返回 true 就以为能解——它只是告诉你这个 entry 被标记为加密，不代表 PHP 能处理它 - 用
libzip>= 1.8.0 + PHP 8.2+ 也不行：目前仍无解密 ZIP 传统加密的 API 支持
解压带密码 ZIP 的实际可行方案：用系统命令 + exec()
绕过 PHP 自身限制的最可靠方式，是调用宿主机已安装的解压工具。Linux/macOS 推荐 7z（支持 ZIP 传统加密），Windows 推荐 7z.exe 或 unzip -P（后者仅支持部分 ZIP 加密格式，稳定性差）。
示例（Linux）：
立即学习“PHP免费学习笔记（深入）”；
$zipFile = '/path/to/protected.zip';
$password = '123456';
$destDir = '/tmp/unzip_here';
<p>// 确保 7z 已安装：<code>which 7z</code>
$cmd = escapeshellcmd("7z x {$zipFile} -p{$password} -o{$destDir} -y");
exec($cmd, $output, $returnCode);</p><p>if ($returnCode !== 0) {
error_log('7z 解压失败：' . implode("\n", $output));
}
-
escapeshellcmd()必须用，防止密码或路径含空格、$、` 等触发命令注入 -
-y是自动确认，避免卡住；-o后路径不能有空格（否则需额外引号包裹） - 注意
7z对 ZIP 密码支持比unzip更全，尤其是老式 ZIP 加密（ZipCrypto） - Web 环境下要确认 PHP 进程有权限执行外部命令，且
exec未被禁用（查看disable_functions）
PHP 8.2+ 的 ZipArchive::setPassword() 是干啥的
这个方法只在「创建或修改 ZIP 包」时起作用，和解压无关。典型场景是：向 ZIP 中添加新文件，并要求该文件条目加密（不是整个 ZIP 加密）。
示例：
$zip = new ZipArchive();
$zip->open('new.zip', ZipArchive::CREATE);
$zip->addFromString('secret.txt', 'top secret');
$zip->setPassword('abc'); // 下一步 add* 操作才会对新增项启用加密
$zip->addFile('/tmp/plain.txt', 'plain.txt'); // 这个文件不会被加密
$zip->addFromString('encrypted.txt', 'hidden'); // 这个会被加密
$zip->close();
- 它不设置 ZIP 整体密码，也不影响已有条目
- 加密后生成的 ZIP，仍需靠
7z等工具才能解压，PHPZipArchive依然无法读取这些加密条目 - 密码只应用于后续的
addFile()/addFromString()，不是全局开关
真正需要密码解压时，别硬扛 PHP 原生类
如果你的业务必须在 PHP 层完成密码 ZIP 解压，又不能依赖系统命令（比如 FaaS 环境、容器无 7z），那只能换方案：让上游改用非加密 ZIP + HTTPS 传输，或改用 AES 加密的 ZIP 并配合纯 PHP 实现（如 php-zip-crypto 库，但维护差、性能低、兼容性有限）。
多数生产环境里，用 7z 是最快落地的解法。但务必检查三点：命令是否存在、密码是否可能含特殊字符（建议 Base64 编码后再传给 shell）、解压目标目录是否有写权限且空间充足。
