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 脚本里写 查 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）。
在线解压缩 ZIP 文件时 ZipArchive::open 返回 false 怎么办
$zip->open() 返回 false 或整数错误码（如 ZIPARCHIVE::ER_NOZIP），不代表扩展没启，而是具体操作失败。常见于 Web 场景下权限、路径、标志误用。
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 路径不可写：确保 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” 路径为准，而不是凭印象去改。
