根本原因是PHP的ZipArchive类不可用且系统缺少unzip命令——两者缺一都会导致Composer解压失败；需根据系统安装unzip并验证ZipArchive实际可用性。
Composer 报 “Unzip with unzip command failed” 或卡在解压阶段，根本原因不是 ZIP 包坏了，而是 PHP 的 ZipArchive 类不可用，且系统缺少 unzip 命令作为备选方案 —— 两者缺一都会让 Composer 在解压时彻底掉链子。
为什么 Composer 需要系统级 unzip 命令？
Composer 默认优先用 PHP 的 ZipArchive 扩展解压，但该扩展在某些环境（如 Alpine、最小化 CentOS、或禁用了 zlib 的 PHP）下可能被禁用或不可用。此时 Composer 会 fallback 到调用系统命令 unzip。如果连这个命令都没有，就会报错：Unzip with unzip command failed, falling back to ZipArchive class（注意：这句日志其实是“试图 fallback 却失败了”的信号，不是成功提示）。
- 它不依赖
zip命令（那是用来打包的），只依赖unzip - 部分发行版（如 Alpine、某些 Docker 镜像）默认不装
unzip，只带busybox unzip，但后者不支持 ZIP64 或数据描述符，Composer 明确拒绝使用 - 即使
php -m | grep zip显示已加载，也可能因disable_functions或open_basedir限制导致ZipArchive::extractTo()实际不可用，此时更需要unzip命令兜底
Linux 各发行版安装 unzip 的实操命令
别猜包名，直接按你当前系统执行对应命令。装完立刻生效，无需重启 PHP 或服务。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
Ubuntu/Debian：
sudo apt update && sudo apt install -y unzip -
CentOS/RHEL 7：
sudo yum install -y unzip -
CentOS/RHEL 8+ / Fedora：
sudo dnf install -y unzip -
Alpine（Docker 常见）：
apk add --no-cache unzip（务必加--no-cache，否则镜像体积暴增） -
检查是否装成功：
unzip -v应输出版本号；which unzip应返回路径（如/usr/bin/unzip）
光装 unzip 不够？还得确认 ZipArchive 真可用
装了 unzip 只是保底手段，真正高效稳定的是 PHP 原生 ZipArchive。很多问题表面是 “unzip 缺失”，实际是 ZipArchive 被悄悄禁用了。
- 运行
php -r "new ZipArchive();"，若报Class 'ZipArchive' not found，说明扩展没加载 —— 此时必须先解决php-zip扩展（不是unzip命令） - 运行
php -i | grep "disable_functions"，确认proc_open没被禁用（ZipArchive内部依赖它） - 运行
php -m | grep zip，有输出 ≠ 可用；再试php -r "var_dump(class_exists('ZipArchive'));"，输出bool(true)才算过关 - 如果用宝塔、AMH 等面板，检查 PHP 设置里是否勾选了“禁用函数”中的
proc_open或system—— 它们会间接让ZipArchive失效
验证是否真修好了：绕过缓存重试 + 查看详细日志
别急着跑 composer install，先清缓存并强制走新环境，否则 Composer 可能复用之前失败时留下的损坏 ZIP 文件。
- 删缓存：
composer clear-cache - 强制跳过缓存下载：
composer install --no-cache -v（-v能看到具体哪个包在解压、用的是ZipArchive还是unzip） - 如果仍失败，加
COMPOSER_DISABLE_ZLIB=1临时关闭压缩流（仅调试用）：COMPOSER_DISABLE_ZLIB=1 composer install --no-cache - 关键观察点：日志中出现
Extracting archive且无报错，才说明解压链路通了；若还卡在Downloading后瞬间崩，大概率是网络或镜像问题，和unzip无关
最容易被忽略的一点：Docker 构建中，unzip 装在 builder 阶段，但最终运行镜像里没装 —— 这会导致 composer install 成功，而后续脚本里调用 ZipArchive 或其他依赖解压的操作静默失败。所以，unzip 和 php-zip 要按需出现在所有可能触发解压的环境中，不能只图 build 阶段能过。
