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免费学习笔记(深入)”;