Composer 报错“unzip 未找到”是因为其依赖系统级 unzip 命令解压 ZIP 包，而最小化 Linux

系统、Alpine Docker 镜像等常未预装；需按系统执行对应安装命令（如 apt install unzip 或 apk add unzip），并验证 unzip -v 输出版本信息。

为什么 Composer 报错 unzip 未找到

Composer 在安装某些包（尤其是含 ZIP 发布资产的包，如 Laravel 的 laravel/installer 或部分私有仓库包）时，会调用系统命令 unzip 解压 ZIP 文件。如果系统没装这个命令，就会报类似这样的错误：

Failed to download vendor/package: The zip extension and unzip command are both missing.

注意：这里不是 PHP 的 zip 扩展没启用（那是另一回事），而是系统级的 unzip 命令不可用——常见于最小化安装的 Linux 发行版（如 Alpine、CentOS Stream、Ubuntu Server minimal）或某些 Docker 基础镜像。

不同系统安装 unzip 的命令

确认是否已安装可执行：which unzip 或 unzip -v；没输出就说明缺失。按环境直接运行对应命令：

• Ubuntu / Debian：sudo apt update && sudo apt install -y unzip
• CentOS / RHEL / AlmaLinux：sudo yum install -y unzip（旧版）或 sudo dnf install -y unzip（新版）
• Alpine Linux（常用于 Docker）：apk add --no-cache unzip
• macOS（Homebrew）：brew install unzip（通常已自带，但 M1/M2 某些精简环境可能缺失）

装完后建议验证：unzip -v 应输出版本信息，且 Composer 再次运行 composer install 不再卡在解压环节。

不装 unzip 的临时替代方案（不推荐长期用）

如果你无法安装系统工具（比如受限容器、CI 环境权限不足），可让 Composer 回退到纯 PHP 解压逻辑（需 PHP 启用 zip 扩展）：

• 确保 PHP zip 扩展已加载：php -m | grep zip，若无输出则需启用（如 sudo phpenmod zip 或修改 php.ini）
• 强制 Composer 使用 PHP 解压：composer config -g archive-format zip（其实默认就是 zip，关键在禁用系统命令）
• 更直接的方式是设置环境变量：export COMPOSER_NO_INTERACTION=1 && export COMPOSER_DISABLE_TTY=1，并确认没有显式配置 "use-zip": false 在 composer.json 的 config 下

但要注意：PHP zip 扩展解压大文件较慢，且某些带特殊路径或符号链接的 ZIP 包可能行为不一致——unzip 命令仍是首选。

Docker 中容易忽略的点

很多自定义 PHP 镜像（尤其基于 php:alpine 或 php:slim）默认不含 unzip，只靠 zip 扩展不够。即使你 RUN 了 pecl install zip，仍要额外装系统 unzip：

• Alpine 镜像中漏掉 apk add unzip 是高频翻车点
• 多阶段构建时，unzip 必须出现在最终运行 Composer 的那一层，不能只在 builder 阶段装
• 某些 CI 平台（如 GitLab Runner 的 docker executor）使用缓存镜像，需确认基础镜像是否已预装 unzip，否则每次都要重装

最稳妥的做法是在 Dockerfile 开头就加上对应安装指令，别依赖“应该有了”这种假设。

# php  # linux  # laravel  # centos  # js  # git  # json  # docker  # composer  # ubuntu  # format  # macos  # gitlab  # debian  # 镜像  # 报错  # 会报  # 未找到  # 如果你  # 是在  # 是因为  # 尤其是  # 那是  # 都要 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： 如何打造高效商业网站？建站目的决定转化率  如何用VPS主机快速搭建个人网站？  Python面向对象测试方法_mock解析【教程】  Gemini手机端怎么发图片_Gemini手机端发图方法【步骤】  武汉网站设计制作公司,武汉有哪些比较大的同城网站或论坛，就是里面都是武汉人的？  韩国服务器如何优化跨境访问实现高效连接？  如何用狗爹虚拟主机快速搭建网站？  济南网站建设制作公司,室内设计网站一般都有哪些功能？  Bootstrap CSS布局之列表  Android中AutoCompleteTextView自动提示  百度浏览器ai对话怎么关 百度浏览器ai聊天窗口隐藏  瓜子二手车官方网站在线入口 瓜子二手车网页版官网通道入口  HTML5空格和margin有啥区别_空格与外边距的使用场景【说明】  移动端脚本框架Hammer.js  微信小程序 require机制详解及实例代码  Laravel如何集成第三方登录_Laravel Socialite实现微信QQ微博登录  三星、SK海力士获美批准：可向中国出口芯片制造设备  悟空识字如何进行跟读录音_悟空识字开启麦克风权限与录音  大连网站制作公司哪家好一点,大连买房网站哪个好？  DeepSeek是免费使用的吗 DeepSeek收费模式与Pro版本功能详解  Laravel用户密码怎么加密_Laravel Hash门面使用教程  如何快速打造个性化非模板自助建站？  做企业网站制作流程,企业网站制作基本流程有哪些？  uc浏览器二维码扫描入口_uc浏览器扫码功能使用地址  在Oracle关闭情况下如何修改spfile的参数  Laravel如何升级到最新版本？（升级指南和步骤）  清除minerd进程的简单方法  Laravel如何实现多级无限分类_Laravel递归模型关联与树状数据输出【方法】  如何快速搭建高效香港服务器网站？  Android 常见的图片加载框架详细介绍  如何快速搭建安全的FTP站点？  北京网页设计制作网站有哪些,继续教育自动播放怎么设置？  jquery插件bootstrapValidator表单验证详解  学生网站制作软件,一个12岁的学生写小说，应该去什么样的网站？  Laravel中的withCount方法怎么高效统计关联模型数量  如何快速搭建高效WAP手机网站吸引移动用户？  高端建站三要素：定制模板、企业官网与响应式设计优化  Laravel队列由Redis驱动怎么配置_Laravel Redis队列使用教程  如何解决hover在ie6中的兼容性问题  Laravel如何处理表单验证？（Requests代码示例）  Python文本处理实践_日志清洗解析【指导】  Laravel Seeder填充数据教程_Laravel模型工厂Factory使用  如何构建满足综合性能需求的优质建站方案？  BootStrap整体框架之基础布局组件  Laravel如何集成Inertia.js与Vue/React？（安装配置）  教学论文网站制作软件有哪些,写论文用什么软件 ？  如何在阿里云虚拟机上搭建网站？步骤解析与避坑指南  JS弹性运动实现方法分析  Laravel怎么导出Excel文件_Laravel Excel插件使用教程  🚀拖拽式CMS建站能否实现高效与个性化并存？