“Failed to extract”或“The PHP file is corrupted”本质是本地缓存ZIP损坏,应先通过composer install -v定位问题包,再精准删除对应~/.composer/cache/files/下ZIP文件,同步清理vendor/和composer.lock,并执行composer install --no-cache --force-checksums重装。

“Failed to extract”或“The PHP file is corrupted”这类报错,基本不是网络问题,而是本地缓存 ZIP 文件损坏了——删对文件比清全量缓存更有效。
定位损坏包的 ZIP 文件
Composer 报错时不会直接告诉你哪个 ZIP 坏了,但 composer install -v 输出末尾会显示最后尝试解压的包路径,比如:Extracting monolog/monolog 或 Downloading symfony/console。这个包名就是关键线索。
- 查缓存根目录:
composer config --global cache-dir(Linux/macOS 通常是~/.composer/cache,Windows 是%APPDATA%\Composer\Cache) - 进
files/子目录,按包名模糊搜索:ls -l *monolog*monolog*.zip(Linux/macOS)或 PowerShell 中Get-ChildItem "$env:APPDATA\Composer\Cache\Files" -Recurse -Filter "*monolog*.zip" - 只删匹配的 ZIP,别碰
repo/和vcs/——它们不参与解压流程
必须同步清理 vendor/ 和 composer.lock
删完坏 ZIP 还报错?大概率是 composer.lock 里硬编码的 dist.sha256 值和当前缓存不匹配,Composer 拒绝安装。只清缓存、只删 vendor/ 都绕不过这个校验。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 先备份:
cp composer.lock composer.lock.bak(Linux/macOS)或copy composer.lock composer.lock.bak(Windows) - 删干净:
rm -rf vendor composer.lock或rd /s /q vendor & del composer.lock - 重装时加两个关键参数:
composer install --no-cache --force-checksums——--no-cache跳过读本地 ZIP,--force-checksums让校验失败立刻退出,不污染vendor/
为什么 composer clear-cache 经常不管用
它会删掉所有缓存,但 Composer 默认仍可能复用已损坏的 ZIP 副本:不重新下载,只校验旧哈希,结果还是失败。更糟的是,CI 环境中若 composer.lock 含旧源地址(比如指向 packagist.org 而非镜像),重装永远走错路。
-
clear-cache不解决composer.lock与缓存哈希不一致的问题 - 镜像配置写错(比如键名写成
repos.packagist而非repo.packagist)会导致下载仍走官方源,缓存再干净也没用 - 某些 IDE(如 PHPStorm)后台扫描缓存 ZIP,导致
clear-cache提示 Permission denied,得先关插件再试
真正卡住的点往往不在缓存本身,而在 composer.lock 的哈希锁定和镜像配置是否生效——漏掉这两项,删光硬盘也白搭。

















