verify-checksums 命令仅校验 vendor/ 中已解压文件与 composer.lock 的 dist.sha256 是否一致,不检查临时 zip 文件;临时文件在校验发生在下载器内部且仅限下载时,verify-checksums 从不读取缓存目录。

verify-checksums 命令只校验 vendor/ 下已解压的文件,不碰临时下载文件
Composer 没有“校验临时文件完整性”的独立命令或开关。所谓临时文件(如 composer/cache/files/xxx.zip)在下载完成后即被解压、校验、丢弃——校验动作发生在解压前,且仅针对 dist 包的 dist.sha256 字段,不是事后扫描缓存目录。
常见误解是:删掉 vendor/ 后运行 composer install,以为能“重新校验临时包”。其实只要缓存命中,Composer 就直接复用本地 zip,跳过网络下载和哈希比对;只有缓存失效或加了 --no-cache 才会重新拉取并校验。
-
verify-checksums从不读取临时 zip 文件,它只比对composer.lock中的dist.sha256和vendor/里实际解压出的 PHP 文件内容 - 临时 zip 的 SHA256 校验发生在下载器内部(
FileDownloader),失败则直接报错退出,不会落地到缓存目录 - 想强制触发完整校验链(下载 → 校验 → 解压 → 再校验),必须同时满足:
COMPOSER_EXPERIMENTAL=1+composer verify-checksums --strict+vendor/已存在且含 dist 包
缓存 zip 被篡改后怎么发现?
Composer 不主动监控缓存目录,但你可以手动验证。临时 zip 文件位于 composer/cache/files/ 下,命名形如 vendor-package-name-zip-hash.zip。它的哈希值不记录在 composer.lock 中,因此无法用 verify-checksums 覆盖。
若怀疑缓存污染(比如 CI 构建中复用了被中间层修改过的 zip),需人工比对:
- 从
composer.lock中找到对应包的dist.url和dist.sha256 - 用
curl -sL算出真实哈希| sha256sum - 再对本地缓存 zip 执行
sha256sum vendor/package-name-hash.zip - 两者不一致,说明缓存已坏——此时应运行
composer clear-cache,而非只删vendor/
CI 流程中必须绕过缓存做端到端校验
CI 环境下,不能依赖本地缓存的完整性。哪怕 verify-checksums 通过,也只代表当前 vendor/ 和 composer.lock 对得上,不保证 zip 源头干净。
安全做法是彻底切断缓存路径,强制走网络+校验:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 设环境变量:
COMPOSER_CACHE_DIR=/dev/null(Linux/macOS)或set COMPOSER_CACHE_DIR=NUL(Windows) - 禁用镜像源,直连官方:
composer config -g repo.packagist composer https://packagist.org - 强制重装并开启哈希校验:
composer install --no-cache --force-checksums - 最后补一记:
composer verify-checksums --strict,确认解压结果无偏差
注意:--force-checksums 不是“多校验一次”,而是让 Composer 在安装阶段就拒绝使用缓存中缺失 dist.sha256 的包——这对私有源或旧版镜像尤其关键。
为什么你看到的“校验失败”往往和临时文件无关
绝大多数 hash verification failed 报错,根因不在临时 zip,而在三者不一致:composer.lock 记的哈希、镜像源返回的元数据、实际下载的 zip 内容。国内镜像同步延迟最常导致这个现象。
典型信号包括:
- 切回
https://packagist.org后错误消失 - 报错提示
dist.sha256不存在或为空,但包明明有 dist 分发 -
composer diagnose显示signature verification: FAIL(说明启用了签名但镜像没透传)
这时清缓存、删 vendor/、重写 composer.lock 是必要动作,但核心要解决的是元数据源一致性——不是临时文件本身出了问题。










