composer install --dry-run可预判部署行为:模拟安装并输出操作步骤,需检查path依赖是否被跳过、是否误走dist模式、是否存在PHP版本不兼容警告,且依赖lock文件有效。

如何用 composer install --dry-run 预判部署行为
部署前最轻量的依赖状态校验,就是不真正安装、只模拟执行。运行 composer install --dry-run 会输出每一步将要做的操作,关键看三类信息:
- 是否提示
Skipping package vendor/package (path repository)—— 表明 path 类型本地依赖已被识别 - 是否出现
Installing vendor/package (dev-main)并带 hash —— 很可能走的是 dist 模式,path 配置失效 - 是否有
Package foo/bar is not available in a version compatible with your PHP version这类 platform 不匹配警告——说明config.platform和实际运行环境不一致
注意:该命令依赖 composer.lock 存在且未被修改。如果 lock 文件已删或内容过期,它会退化为 composer update --dry-run 行为,结果不可靠。
\Composer\InstalledVersions 在部署脚本中做运行时断言
光看安装日志不够,得让 PHP 自己确认。把以下逻辑写进部署前的健康检查脚本(如 bin/health-check.php):
if (!\Composer\InstalledVersions::isInstalled('monolog/monolog')) {
throw new RuntimeException('monolog/monolog is missing — aborting deploy');
}
if (!\Composer\InstalledVersions::satisfies(new \Composer\Semver\VersionParser, 'laravel/framework', '^10.0')) {
throw new RuntimeException('laravel/framework version mismatch');
}
这个类从 Composer 2.0 起内置,无需额外 require;但要注意:
- 必须确保
vendor/autoload.php已加载,否则会报Class not found - 若检查
require-dev包,需显式传false第二个参数:\Composer\InstalledVersions::isInstalled('phpunit/phpunit', false) - 它读取的是当前
vendor/状态,不是composer.json声明 —— 所以适合验证“实际装了什么”,而非“应该装什么”
为什么 composer validate --strict 必须和 audit 一起跑
部署前漏掉 composer validate --strict,等于放行一堆隐性故障点。它会立刻暴露:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
-
config.platform.php声明为"8.2",但某个依赖的composer.json中写了"php": ">=8.3"—— 安装时看似成功,运行时报ParseError -
autoload路径指向不存在的目录,导致类自动加载失败(class_exists()返回false) - 自定义仓库 URL 是相对路径或 HTTP(非 HTTPS),CI 中被安全策略拦截
和 composer audit --dev 配合时,顺序很重要:validate 应在 audit 之前执行。因为 audit 只查漏洞,不拦语法错误;而 validate --strict 一旦失败,后续步骤就不该继续。
CI 中别信 composer install 退出码为 0 就万事大吉
很多 CI 脚本只检查 composer install 是否返回 0,但这掩盖了三类严重问题:
- path 依赖被降级为 copy 模式(
vendor/下是真实文件夹,不是符号链接),导致本地改动不生效 - lock 文件中某包的
source.type是dist而非path,但install仍成功 —— 因为 Composer 默认 fallback 到 packagist - PHP 版本或扩展缺失时,
install仍成功(只是跳过某些包),但运行时炸
真正可靠的 CI 步骤应包含:
composer install --no-interaction --prefer-dist composer install --dry-run | grep -q "Skipping.*path" || exit 1 php bin/health-check.php composer validate --strict composer audit --dev --no-interaction --severity=high,critical
最后那条 grep -q "Skipping.*path" 是专治 path 依赖静默失效的硬核检查——没看到 Skipping,就说明配置根本没起作用。










