出现“ZipArchive not found”错误是因PHP缺少zip扩展支持。2. 运行php -m | grep zip检查是否安装。3. 未安装则根据系统选择对应命令安装:Ubuntu用sudo apt-get install php-zip,CentOS用sudo yum install php-zip,macOS用brew install libzip,Windows需在php.ini中启用extension=zip。4. 重启服务后验证扩展加载,即可解决Composer报错。

在使用 Composer 安装 PHP 项目依赖时,如果遇到 “ZipArchive not found” 错误,说明 PHP 环境中缺少对 ZipArchive 类的支持。这个类是 PHP 的 zip 扩展提供的,Composer 需要它来解压下载的包。以下是几种常见的修复方法。
检查 zip 扩展是否已安装
打开终端或命令行,运行以下命令查看当前 PHP 是否启用了 zip 扩展:
php -m | grep zip如果输出中没有 zip,说明扩展未启用或未安装。
启用或安装 zip 扩展
根据你的操作系统和 PHP 安装方式,操作略有不同:
-
Linux(Ubuntu/Debian):
运行以下命令安装 zip 扩展:
如果你使用的是特定版本的 PHP(如 php8.1),请替换为:
sudo apt-get install php8.1-zip-
Linux(CentOS/RHEL):
使用 yum 或 dnf 安装:
或(对于较新版本):
sudo dnf install php-zip-
macOS(使用 Homebrew):
如果你通过 Brew 安装了 PHP,可以尝试:
然后重新安装或启用 zip 扩展。某些 PHP 版本可能需要手动编译扩展。
-
Windows:
打开 php.ini 文件(通常位于 PHP 安装目录),确保以下行未被注释:
如果前面有分号(;),请删除它。保存后重启 Web 服务器(如 Apache 或 Nginx)或 PHP-FPM。
验证修复结果
运行以下命令确认 zip 扩展已加载:
php -m | grep zip应看到输出 zip。之后再次运行 Composer 命令,错误通常会消失。
基本上就这些。只要确保 zip 扩展正确启用,Composer 就能正常处理压缩包。










