composer提示”The zip extension is required”怎么办

2025-11-04 0 356

答案是启用 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,命令应为:

composer提示”The zip extension is required”怎么办
查看详情
composer提示”The zip extension is required”怎么办
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中文网其它相关文章!

收藏 (0) 打赏

感谢您的支持,我会继续努力的!

打开微信/支付宝扫一扫,即可进行扫码打赏哦,分享从这里开始,精彩与您同在
点赞 (0)

遇见资源网 开发工具 composer提示”The zip extension is required”怎么办 https://www.ox520.com/2126.html

常见问题

相关文章

猜你喜欢
发表评论
暂无评论
官方客服团队

为您解决烦忧 - 24小时在线 专业服务