php --ini可查看CLI模式加载的php.ini路径，而Web模式需通过phpinfo()获取“Loaded Configuration File”路径，两者常不一致，导致扩展启用后CLI或Web端仍报错。
确认当前 PHP CLI 和 Web 使用的 php.ini 是否一致
很多人改了 php.ini 却发现 Composer 还是报 Class 'ZipArchive' not found，或者网页里调用失败，根本原因是：XAMPP 的 Apache（Web）和命令行（CLI）可能加载不同的配置文件。运行 php --ini 查看 CLI 加载路径，再在 PHP 脚本里写 <?php echo php_ini_loaded_file(); ?> 查 Web 加载路径——两者常不一致。
常见情况包括：
– XAMPP 安装后默认只在 Apache 的 php.ini 里启用扩展，但 php -v 或 composer install 走的是 CLI 版 PHP，它可能读的是另一个 php.ini（比如 C:\xampp\php\php.ini 是对的，但 CLI 实际读的是 C:\xampp\php\php-cli.ini）；
– 某些旧版 XAMPP（如 8.0 以前）的 CLI 配置文件甚至不存在，此时必须手动复制一份或确保 extension 行在主 php.ini 中且被 CLI 识别。
实操建议：
– 先执行 php --ini，确认 CLI 加载的 php.ini 路径；
– 打开该文件，搜索 extension=php_zip.dll，去掉前面的分号；
– 同时检查该 php.ini 中 extension_dir 指向是否正确（例如 extension_dir = "ext" 或绝对路径 extension_dir = "C:\xampp\php\ext"）；
– 保存后，用 php -m | grep zip 验证 CLI 是否识别；
– 若仍失败，直接运行 php -r "new \ZipArchive();"，报错才真实反映类是否可用。
Windows 下 XAMPP 启用 ZipArchive 的三步实操
XAMPP 自带 php_zip.dll，但默认是注释掉的。关键不是“安装”，而是“解注释 + 校验路径 + 重启对应服务”。
操作步骤：
– 用记事本或 VS Code 打开 C:\xampp\php\php.ini（不是 Apache 目录下的那个）；
– 搜索 php_zip.dll，找到形如 ;extension=php_zip.dll 的行，删掉开头的分号；
– 确保上一行 extension_dir = "ext" 未被注释，且 C:\xampp\php\ext\php_zip.dll 文件真实存在；
– 重启 Apache（通过 XAMPP Control Panel）；
– 若用 CLI（如 Composer），还需关闭并重开终端，让新环境变量/配置生效。
注意：
– 不要复制网上的 extension=zip（这是 Linux/macOS 写法，Windows 下会无效）；
– 不要手动下载 PECL 的 DLL 替换，XAMPP 自带版本已适配其 PHP ABI，混用易导致 Apache 启动失败；
– 修改后若 Apache 启动报错（日志里出现 “PHP Startup: Unable to load dynamic library”），说明 DLL 路径不对或 ABI 不匹配，立刻还原 php.ini 并核对 PHP 版本（如 XAMPP 8.2.12 对应 PHP 8.2.x）。
XAMPP 8.0.30 是一款免费、开源的跨平台 Web 服务器集成包，专为快速搭建本地 PHP 开发环境而设计。该版本核心组件包括：Apache 2.4.56、MySQL 8.0.33、PHP 8.0.30、phpMyAdmin 5.2.1 等。它支持 Windows、Linux 和 macOS 系统，可让开发者在个人电脑上轻松模拟服务器环境，无需复杂配置即可运行 WordPress、Thin
在线解压缩 ZIP 文件时 ZipArchive::open 返回 false 怎么办
$zip->open() 返回 false 或整数错误码（如 ZIPARCHIVE::ER_NOZIP），不代表扩展没启，而是具体操作失败。常见于 Web 场景下权限、路径、标志误用。
典型原因与对策：
– 目标 ZIP 路径不可写：确保 open($filename, ZipArchive::CREATE) 中的 $filename 所在目录（如 /xampp/htdocs/tmp/）对 Apache 用户（通常是 daemon 或 www-data）有写权限；
– 错误使用标志：创建新 ZIP 必须用 ZipArchive::CREATE，解压已有 ZIP 应用 ZipArchive::RDONLY 或直接 open($file)；
– 文件名含中文或特殊字符：Windows 下需确保 PHP 文件系统编码与路径一致，建议用 mb_convert_encoding($path, 'CP1252', 'UTF-8') 转码（仅限 Windows）；
– 调用前未清空输出缓冲：如果页面已有 HTML 输出，ZipArchive::open 可能静默失败，加 ob_end_clean() 开头可排除干扰。
调试技巧：
– 不要只看 if (!$zip->open(...))，改用 $res = $zip->open(...); var_dump($res); 查具体错误码；
– 错误码对照表可查 PHP 官方文档 ZipArchive::ER_* 常量；
– 在线解压逻辑中，务必用 is_uploaded_file() 校验上传文件，再传给 ZipArchive::open()，避免路径穿越风险。
为什么 phpinfo() 显示 zip support enabled，但 new ZipArchive() 仍报错
最常被忽略的一点：命名空间污染。PHP 7.4+ 默认开启严格模式，而 ZipArchive 是全局类，若当前代码在命名空间内（如 namespace App;），直接写 new ZipArchive() 会被解析为 App\ZipArchive，自然找不到。
解决方法只有一条：
– 在实例化前加反斜杠：$zip = new \ZipArchive();；
– 或在文件顶部加 use ZipArchive;（推荐，更清晰）。
其他可能性：
– 启用了 OPcache 且缓存了旧字节码，修改 php.ini 后未清除 OPcache（opcache_reset() 或重启 Apache）；
– 某些安全加固的 XAMPP 版本（如某些企业定制包）禁用了动态扩展加载，需检查 enable_dl = Off 是否被设为 Off（应为 On，但现代 PHP 默认 Off，实际不影响内置扩展）；
– 最隐蔽的坑：多个 PHP 版本共存，浏览器访问的 phpinfo() 是 Apache 加载的 PHP，而你编辑的 php.ini 是另一个版本的——务必用 phpinfo() 页面底部的 “Loaded Configuration File” 路径为准，而不是凭印象去改。
