0

0

解决Composer提示“The zip extension and unzip command are both missing”的错误

冰火之心

冰火之心

发布时间:2026-01-04 14:07:02

|

886人浏览过

|

来源于php中文网

原创

composer报该错误是因为php zip扩展未启用且系统unzip命令缺失;它优先用zip扩展解压,失败后回退到unzip命令,两者皆无则报错退出。

解决composer提示“the zip extension and unzip command are both missing”的错误

为什么 Composer 会报 “The zip extension and unzip command are both missing”

这个错误不是 Composer 自身出问题,而是它在安装包时发现两个关键解压能力都不可用:zip PHP 扩展未启用,且系统级 unzip 命令也找不到。Composer 默认优先用 PHP 的 zip 扩展解压 ZIP 包(比如从 packagist 下载的 .zip 归档), fallback 到系统 unzip 命令;两者全缺,就直接报错退出。

检查并启用 PHP 的 zip 扩展

多数 Linux/macOS 发行版的 PHP 默认不启用 zip 扩展,Windows 的 php.ini 里它常被注释掉。先确认是否加载:

php -m | grep zip

如果无输出,说明未启用。解决方式依环境而定:

  • Ubuntu/Debian:sudo apt install php-zip,然后重启 Web 服务或 CLI PHP(无需改 php.ini)
  • CentOS/RHEL:sudo yum install php-pecl-zipdnf install php-pecl-zip
  • macOS(Homebrew PHP):brew install php@8.2-zip(版本号按需替换),再检查 php --ini 找到配置目录,确认 extension=zip.so 已写入 php.ini
  • Windows:打开 php.ini,取消 ;extension=zip 前的分号,保存后重启 Apache/Nginx 或终端

验证系统是否有 unzip 命令并加入 PATH

即使启用了 PHP zip 扩展,某些包(尤其是含 symlink 或特殊权限的)仍依赖 unzip 命令。运行以下命令检查:

which unzip

若无输出,需安装:

AI角色脑洞生成器
AI角色脑洞生成器

一键打造完整角色设定,轻松创造专属小说漫画游戏角色背景故事

下载
  • Ubuntu/Debian:sudo apt install unzip
  • CentOS/RHEL:sudo yum install unzip
  • macOS:brew install unzip(或用 brew install p7zip 后软链,但推荐原生 unzip)
  • Windows:从 Info-ZIP 官网 下载 unzip.exe,放入 PATH 目录(如 C:\Windows),或把它的路径加进系统环境变量

注意:Windows 用户容易忽略 unzip.exe 必须叫 unzip(不能是 unzip64 或带版本号),且必须能被 cmd 或 PowerShell 直接调用(即 unzip -v 能返回版本信息)。

临时绕过 zip 依赖(仅调试用,不推荐长期)

如果实在无法装 zip 扩展或 unzip,可强制 Composer 改用 tar 格式下载(packagist 多数包同时提供 .tar.gz):

composer config -g github-oauth.github.com YOUR_TOKEN  # 可选,避免限流
composer config -g prefer-stable true
composer config -g use-include-path false
composer config -g archive-format tar

但这有局限:

  • 部分私有仓库或老旧包只提供 ZIP,archive-format tar 会直接失败
  • PHP phar 扩展必须启用(否则 tar 解压也会失败)
  • 性能略低,且非标准路径,后续升级可能意外触发 ZIP 回退

真正稳定的做法还是补上 zip 扩展和 unzip 命令——尤其在 CI/CD 环境中,漏掉任意一个都会导致构建中断,而且错误提示不指明具体缺哪个,容易反复试错。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
composer是什么插件
composer是什么插件

Composer是一个PHP的依赖管理工具,它可以帮助开发者在PHP项目中管理和安装依赖的库文件。Composer通过一个中央化的存储库来管理所有的依赖库文件,这个存储库包含了各种可用的依赖库的信息和版本信息。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

161

2023.12.25

nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

245

2023.07.27

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

520

2023.08.04

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

588

2023.08.04

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

244

2024.02.23

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

629

2024.07.09

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

3613

2024.08.07

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

53

2026.01.13

Swift iOS架构设计与MVVM模式实战
Swift iOS架构设计与MVVM模式实战

本专题聚焦 Swift 在 iOS 应用架构设计中的实践,系统讲解 MVVM 模式的核心思想、数据绑定机制、模块拆分策略以及组件化开发方法。内容涵盖网络层封装、状态管理、依赖注入与性能优化技巧。通过完整项目案例,帮助开发者构建结构清晰、可维护性强的 iOS 应用架构体系。

3

2026.03.03

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 12.9万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.3万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 1.0万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号