如何使用Composer引入 PHP-Zip 库处理带密码保护的 ZIP 压缩文件-composer-PHP中文网

ziparchive扩展需手动启用，非composer安装；php原生仅支持传统zip加密解压，不支持aes，密码解压须在open后调用setpassword()且仅限php 7.2+。

如何使用composer引入 php-zip 库处理带密码保护的 zip 压缩文件

确认系统是否支持 ziparchive 扩展

PHP-Zip 并不是一个独立的 Composer 包，而是依赖 PHP 内置的 ziparchive 扩展。如果 ziparchive 未启用，装任何“PHP-Zip”包都没用——常见错误是直接 composer require php-zip 或类似名字，结果运行时报 Class 'ZipArchive' not found。

运行 php -m | grep zip 检查扩展是否已加载（Linux/macOS）
Windows 用户检查 php.ini 中是否取消注释了 extension=zip
phpinfo() 页面里搜索 “zip” 确认 “Zip enabled” 为 true
注意：部分 Docker 镜像（如 php:alpine）默认不带 zip 扩展，需额外安装 apk add zip 并启用扩展

使用 ZipArchive::setPassword() 解压带密码 ZIP

ZipArchive 自 PHP 7.2 起原生支持设置解压密码，但仅限于传统 ZIP 加密（即 PKZIP Legacy Encryption），不支持 AES 加密格式。很多用户误以为能解 WinRAR 或 7-Zip 生成的 AES 密码 ZIP，实际会静默失败或报错 ZipArchive::extractTo(): Invalid or uninitialized Zip object。

必须在 open() 成功后、extractTo() 前调用 setPassword()
密码只对当前打开的 ZIP 文件生效，不全局持久化
示例关键步骤：

$zip = new ZipArchive();
if ($zip->open('protected.zip') === TRUE) {
    $zip->setPassword('123456'); // 必须在这之后再 extract
    $zip->extractTo('./output/');
    $zip->close();
} else {
    echo "无法打开 ZIP 文件";
}

如何判断 ZIP 是否用了 AES 加密（而非传统加密）

没有通用 PHP 函数能直接读取 ZIP 加密方式，但可通过行为和错误间接识别：AES 加密 ZIP 在调用 setPassword() 后仍解压失败，且 ZipArchive::getStatusString() 返回空或无意义信息。此时说明 PHP 原生不支持，需换方案。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

用命令行验证：unzip -l -P dummy_password protected.zip —— 若提示 “skipping: xxx.txt password incorrect (password incorrect?)”，大概率是 AES
Linux/macOS 下可临时用 7z x protected.zip -p123456 测试是否能解；若成功，则需调用外部命令
不要尝试用 exec('unzip -P ...') 传密码，因为 unzip 的密码参数在某些版本中会被 shell 截断或泄露到进程列表
更安全做法：用 proc_open() 启动 7z 并通过 stdin 输入密码（需确保服务器已安装 p7zip-full）

Composer 不该装什么，以及替代方案建议

搜索 “php zip password” 容易找到一些 Composer 包（如 robrichards/zipstream、nelexa/zip），但它们都不支持解密，仅用于生成 ZIP。目前没有稳定、维护良好的 Composer 包能完整替代 ZipArchive 处理密码 ZIP。