Composer报错ZipArchive找不到_PHP开启Zip扩展支持Composer【图文】

ZipArchive类未找到是因php未启用zip扩展，需根据系统手动安装并启用：linux/macos用包管理器安装后检查配置；windows需在php.ini中取消extension=zip注释，并确认php.ini路径正确。

composer 报错 ZipArchive class not found

这是 Composer 在安装或更新包时最典型的扩展缺失错误，本质是 PHP 运行时找不到 ZipArchive 类——它不是默认启用的扩展，必须手动开启。报错通常长这样：
Class 'ZipArchive' not found 或 Failed to download ...: zip extension is required。

确认 PHP 是否启用了 zip 扩展

别猜，直接验证：

• 运行 php -m | grep zip（Linux/macOS）或 php -m 全量查看是否有 zip
• 运行 php -i | grep "zip" 查看是否显示 zip support => enabled
• 如果用 Web 环境（如 apache/nginx），在 index.php 里写 ，浏览器打开后搜索 zip 段落

注意：CLI（命令行）和 Web SAPI 的 PHP 配置文件可能不同，php -i 和 phpinfo() 显示的 Loaded Configuration File 路径要分别核对。

Linux/macOS 下启用 zip 扩展（常见发行版）

多数现代 PHP 包已内置 zip，但默认不加载：

立即学习“PHP免费学习笔记（深入）”；

• debian/ubuntu：sudo apt install php-zip（PHP 8.0+ 对应 php8.0-zip）
• centos/RHEL 8+：sudo dnf install php-zip
• macOS + Homebrew：brew install php@8.2（新版 brew 安装的 PHP 默认含 zip，老版本可补 brew reinstall php@8.2 --with-zip，但该参数已弃用，建议重装）
• 确认扩展已写入配置：检查 /etc/php/*/cli/conf.d/20-zip.ini 或类似路径是否存在，内容应为 extension=zip

改完重启 CLI 无需操作，但 Web 服务需重启：sudo systemctl restart apache2 或 sudo nginx -s reload。

Windows 下启用 php_zip.dll

PHP for Windows 是模块化分发的，zip 扩展需手动放开：

• 打开 php.ini（注意 CLI 和 Web 用的可能是两个文件），搜索 ;extension=zip
• 去掉前面的分号，改为 extension=zip（PHP 8.0+ 推荐写法；旧版可能需写 extension=php_zip.dll）
• 确保 extension_dir 指向正确的目录（如 ext 文件夹），且该目录下存在 php_zip.dll
• 保存后，命令行执行 php -v 看是否报错；若无报错再试 composer install

容易被忽略的是：Windows 下某些集成环境（如 XAMPP、WampServer）自带的 PHP 可能禁用 zip，且其 php.ini 位置藏得深（例如 Wamp 在 C:wamp64binphpphp8.1.13phpForApache.ini），务必确认改的是实际被加载的那个。