XAMPP如何修改默认的PHP zip扩展配置-php教程-PHP中文网

zip扩展在xampp中默认未启用，需取消php.ini中extension=zip的注释、确认extension_dir路径正确、重启apache，并通过phpinfo()和test脚本验证加载成功。

xampp如何修改默认的php zip扩展配置

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），用文本编辑器打开后操作：

btpanel phpsite 宝塔面板PHP网站

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

下载

搜索 ;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：

创建 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