composer update --dry-run 可显示各包版本变化范围,如“monolog/monolog (1.26.0 => 2.10.0)”,不修改 composer.lock;而 composer show --outdated 仅列出理论可升级版本,不反映实际解析结果或降级行为。

更新时显示包的版本变化范围用 composer update --dry-run
默认 composer update 只显示最终安装的版本,不告诉你从哪来、到哪去。想看清每个包到底从 1.2.3 升到了 1.3.0,或者降级到了 0.9.5,必须加 --dry-run 参数——它不会真正写入 composer.lock,但会模拟整个解析过程,并把每个包的「当前版本 → 解析后版本」完整列出来。
常见错误是误用 --verbose 或 -v:它们只增加日志层级(比如显示依赖解析树),并不展示版本对比。只有 --dry-run 才触发 Composer 内部的 diff 逻辑。
- 运行
composer update --dry-run后,输出中每行类似:- Updating monolog/monolog (1.26.0 => 2.10.0) - 若只想看某几个包,可指定包名:
composer update --dry-run guzzlehttp/guzzle symfony/http-foundation - 搭配
--with-dependencies时需谨慎:它会连带更新间接依赖,导致输出变长且易混淆主次
composer show 配合 --outdated 查当前可更新范围
composer show --outdated 不执行更新,只列出所有满足 composer.json 版本约束、但尚未安装的更高版本。它给出的是「理论可升区间」,不是实际更新结果。
例如你的 composer.json 写着 "phpunit/phpunit": "^9.5",而目前装的是 9.5.26,最新稳定版是 9.6.15,那么它会显示:
phpunit/phpunit 9.5.26 ! 9.6.15 The PHPUnit framework
注意那个 ! 符号:表示有新版本可用;但具体更新时会不会真升到 9.6.15,还取决于其他包的约束冲突。所以它不能替代 --dry-run 的实际解析结果。
- 加
-d参数可显示详细依赖路径:composer show --outdated -d - 加
--direct只显示composer.json显式声明的包,排除自动引入的子依赖 - 输出里没有「→」箭头,只有「当前版」和「可用版」两栏,无法反映降级或锁版本行为
为什么 composer update 默认不显示版本变化?
Composer 的设计哲学是「以 lock 文件为准」,只要 composer.lock 没变,就不强调过程。日常 CI 或部署中,多数人只需要确认是否成功,而非审计每条变更。但团队协作或安全升级时,漏看一个包从 2.x 降到 1.x 就可能引发兼容问题。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
真实踩坑场景:某次 composer update 后接口突然 500,查日志发现 symfony/event-dispatcher 被意外降级到 4.4.49(因某个旧组件强制要求),而项目代码已用上 5.4+ 的新 API。这种降级在普通更新输出里完全隐形,只有 --dry-run 提前暴露。
- CI 流水线建议固定加
--dry-run做预检,配合grep "=>"抽取变更行 - 别依赖
git diff composer.lock回溯——它只反映最终状态,看不出 Composer 是主动选版还是被逼妥协 -
composer update --no-install和--dry-run效果不同:前者生成新 lock 但不下载包,后者连 lock 都不改
自定义脚本快速比对两次更新的差异
如果需要长期追踪某类包(比如所有 symfony/*)的版本漂移,可以写个小脚本抓取 --dry-run 输出并结构化。
示例(bash):
composer update --dry-run symfony/* 2>&1 | grep "=>"
输出就是干净的 symfony/console (5.4.32 => 6.4.8) 这类行。再用 awk 或 jq(配合 --format=json)提取字段,就能喂进监控系统。
- 注意
2>&1:因为 Composer 把进度和结果都打到 stderr,不重定向就捕获不到 - 不要用
composer update --dry-run --quiet:它会屏蔽所有输出,包括版本变化行 - 若项目启用了
config.platform,--dry-run仍会尊重该配置,但某些平台包(如ext-redis)的模拟结果可能与真实环境略有出入
实际做版本审计时,最常被忽略的是「约束放宽」带来的隐性升级。比如把 "laravel/framework": "8.75.*" 改成 "^8.75",表面只是语法调整,但下次 update 就可能跨小版本跳到 8.83——这种变化只有 --dry-run 能提前预警。

















