ZIP扩展在XAMPP中默认未启用，需取消php.ini中extension=zip的注释、确认extension_dir路径正确、重启Apache，并通过phpinfo()和test脚本验证加载成功。
ZIP 扩展在 XAMPP 中默认未启用，需手动配置 php.ini 并验证路径与依赖，否则 ZipArchive 类会报错“Class not found”或 extension_loaded('zip') 返回 false。
确认 ZIP 扩展是否已预装但未启用
XAMPP Windows 版（如 8.2/8.3）通常自带 php_zip.dll，但它默认被注释掉。别急着下载新 DLL —— 先验证它是否存在：
- 打开命令行，运行
dir C:\xampp\php\ext\php_zip.dll（路径按你实际安装位置调整），确认文件存在 - 再运行
php -m | findstr zip，若无输出，说明 CLI 下也未启用；若有输出但网页中不生效，大概率是 Apache 加载了另一份php.ini - 务必用
phpinfo()页面顶部的Loaded Configuration File路径为准，不是控制台看到的路径
修改 php.ini 启用 ZIP 并检查 extension_dir
找到 phpinfo() 显示的真实 php.ini 路径（通常是 C:\xampp\php\php.ini），用文本编辑器打开后操作：
- 搜索
;extension=zip或;extension=php_zip.dll—— PHP 7.4+ 推荐写extension=zip（无需后缀），旧版 XAMPP 可能仍需extension=php_zip.dll - 取消该行前的分号，保存文件
- 顺手检查
extension_dir值是否为"C:\xampp\php\ext"（注意：末尾不能带反斜杠\，否则 ZIP 扩展加载失败） - 可选但建议：开启 zlib 压缩支持，确保
zlib.output_compression = On已启用（非 ZIP 必需，但影响压缩流行为）
重启 Apache 后验证 ZIP 是否真正可用
仅改配置不重启等于没改。必须在 XAMPP Control Panel 中完整 Stop → Start Apache：
立即学习“PHP免费学习笔记（深入）”；
- 创建
C:\xampp\htdocs\test-zip.php，内容为：
<?php
if (!extension_loaded('zip')) {
die('ZIP extension not loaded');
}
if (!class_exists('ZipArchive')) {
die('ZipArchive class missing');
}
$info = new ZipArchive();
echo 'OK: ZipArchive is ready';
?>
- 访问
http://localhost/test-zip.php，显示 “OK” 才算成功 - 若报错
Class 'ZipArchive' not found，常见原因是：extension_dir错误、DLL 文件名不匹配、PHP 版本与 DLL 不兼容（比如用 PHP 8.2 加载了 PHP 7.4 的php_zip.dll） - 注意：XAMPP macOS/Linux 版本不自带 ZIP 扩展，需自行编译
.so并配置extension=zip.so，且路径和依赖（如zlib）需手动满足
常见 ZIP 相关错误及快速定位点
遇到 ZIP 功能异常时，优先查这三项，比重装扩展更省时间：
-
PHP Warning: PHP Startup: Unable to load dynamic library 'zip'：说明extension=zip指向的 DLL 找不到或损坏，回到ext目录确认文件存在且权限正常 -
ZipArchive::open(): Invalid or unhandled format：不是扩展问题，而是传入了非法路径或只读目录，检查$zip->open($file, ZIPARCHIVE::CREATE)中的$file是否可写 -
Call to undefined function zip_open()：这是老式 ZIP 函数（已废弃），应改用ZipArchive类，不要混用 API - Windows 下若启用 ZIP 后 GD 或 cURL 失效，可能是 DLL 依赖冲突（如多个版本的
zlib1.dll），此时需统一使用 XAMPP 自带的 DLL，不要额外丢进system32
最易被忽略的是：Apache 和 CLI 使用不同 php.ini，而 php -v 看到的版本和 phpinfo() 显示的可能根本不是同一个环境。动手前，先看一眼 Loaded Configuration File —— 这一行值，决定了你所有修改是否生效。
