PHP操作ZIP的核心是内置zip扩展的ZipArchive类，不存在“phpzip”独立扩展；启用zip扩展后，通过open()、addFile()、extractTo()等方法实现压缩解压，密码加密仅支持解压验证，创建加密ZIP需调用系统zip命令。
PHP 没有独立的 “phpzip 扩展” —— 你看到的 “phpzip” 多是误称或旧文档残留，实际只有 zip 扩展，其核心类就是 ZipArchive。 所有压缩/解压 ZIP 文件的操作，都必须通过启用 zip 扩展 + 实例化 ZipArchive 类完成。不存在两个并行的、功能重叠的“zip 扩展”可选。
为什么找不到 php_zip.so 或 phpzip.ini 配置项
因为根本不存在名为 phpzip 的独立扩展模块。PHP 自 5.3 起已将 zip 扩展内置进核心，Linux 发行版通常随 php-common 或 php-zip 包提供，Windows 下对应 php_zip.dll（但文件名仍是 zip，不是 phpzip）。
常见错误现象：
- 在
php.ini里搜phpzip或extension=phpzip→ 找不到，启用失败 -
php -m | grep zip输出为空 → 实际是没装php-zip包，或 Windows 下未取消注释extension=zip - 调用
new ZipArchive()报错Class 'ZipArchive' not found→ 不是类名写错，而是扩展根本未加载
正确做法：
- Debian/Ubuntu：
sudo apt install php-zip，然后确认extension=zip在php.ini中已启用 - CentOS/RHEL：
sudo yum install php-pecl-zip或dnf install php-zip - Windows：打开
php.ini，取消;extension=zip前的分号 - 重启 Web 服务（
apache2/php-fpm）或 CLI 环境
ZipArchive::CREATE 和 ZipArchive::OVERWRITE 的行为差异
这两个常量控制的是 open() 方法对已有 ZIP 文件的处理逻辑，直接影响文件是否被意外追加或覆盖。
使用场景：
- 你要生成一份全新归档（比如用户下载打包），且不能容忍旧内容残留 → 必须用
ZipArchive::OVERWRITE - 你要向已有 ZIP 中追加日志、报告等辅助文件（极少见）→ 用
ZipArchive::CREATE
关键细节：
-
ZipArchive::CREATE在文件存在时不会报错，而是打开并允许后续addFile()—— 但若原 ZIP 已损坏，open()可能静默失败 -
ZipArchive::OVERWRITE会直接删掉旧文件再新建，更安全；但如果磁盘无写权限，open()返回ZIPARCHIVE::ER_OPEN（状态码 11）而非布尔 false - 两者在文件不存在时行为一致：都会创建新 ZIP
建议始终显式判断返回值：
$zip = new ZipArchive();
$res = $zip->open('report.zip', ZipArchive::OVERWRITE);
if ($res !== TRUE) {
throw new RuntimeException('ZIP open failed: ' . $zip->getStatusString());
}
密码保护 ZIP 的真实能力边界
ZipArchive 的 setPassword() 方法仅支持「解压时提供密码」，不支持「创建加密 ZIP」——这是硬性限制，不是配置问题。
容易踩的坑：
- 以为调用
$zip->setPassword('123')后再close()就生成了加密 ZIP → 实际密码未生效，文件仍可无密解压 - 尝试用
addFile()添加一个已加密的 ZIP 文件 → ZIP 内容会被当作普通二进制写入，不解密也不校验 - 期望支持 AES-256 加密 →
ZipArchive仅支持传统 ZipCrypto（弱加密），且只用于解压
替代方案：
- 如需生成加密 ZIP，必须调用系统命令：
exec("zip -P '123' archive.zip file.txt", $output, $code) - 注意：该方式绕过 PHP 内存限制，但需确保服务器启用了
zip命令且 Web 用户有执行权限 - 敏感场景下，避免在命令中拼接用户输入，防止 shell 注入
最常被忽略的一点：空 ZIP 归档在 close() 后可能自动消失。如果你 open() 成功、没调任何 add* 方法、直接 close()，libzip 底层会删除这个空文件 —— 这不是 bug，是设计行为。需要空包时，至少用 addFromString('.keep', '') 塞一个占位文件。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
