答案是启用 PHP 的 zip 扩展可解决 “The zip extension is required” 错误。首先通过 php -m | grep -i zip 检查是否加载,若未启用,Windows 用户需在 php.ini 中取消注释 ;extension=zip,Linux 用户安装 php-zip 包,macOS 用户使用 Homebrew 安装对应 PHP 版本,修改后重启服务并验证 zip 是否成功加载,最后重新运行 Composer 命令即可。
出现 “The zip extension is required” 错误,说明 PHP 的 zip 扩展 没有启用。Composer 在安装或更新包时需要这个扩展来解压 .zip 格式的文件,缺少它就无法正常工作。
检查 zip 扩展是否启用
运行以下命令查看当前 PHP 是否加载了 zip 扩展:
php -m | grep -i zip
如果输出中没有 zip,说明扩展未启用。
启用 zip 扩展
根据你的操作系统和 PHP 安装方式,操作略有不同:
- Windows 用户:
打开 php.ini 文件(可通过 php –ini 查找位置),找到这一行:
;extension=zip
去掉前面的分号,改为:
extension=zip
- Linux(如 Ubuntu/Debian):
安装 php-zip 包:
sudo apt-get install php-zip
如果你使用的是特定版本的 PHP,比如 PHP 8.1,命令应为:

查看详情

sudo apt-get install php8.1-zip
- macOS(使用 Homebrew):
确保已安装 PHP 并运行:
brew install php@8.1 # 或你使用的版本 brew link php@8.1
通常 zip 扩展会默认包含。
验证修复结果
修改后,重启 Web 服务(如 Apache 或 Nginx)或 CLI 环境,然后再次运行:
php -m | grep zip
确认 zip 出现在列表中。之后再运行 Composer 命令,错误应该就消失了。
基本上就这些。只要 zip 扩展启用,Composer 就能正常解压依赖包。这个问题常见于本地开发环境或新服务器配置,不复杂但容易忽略。
以上就是composer提示”The zip extension is required”怎么办的详细内容,更多请关注php中文网其它相关文章!

