composer outdated 是查看可更新包最准确的方式,但默认只显示当前锁文件版本与仓库最新稳定版存在差异的包,不包括已锁定或兼容范围内的版本;需加 –all、–direct 等参数才能全面掌握升级空间。
直接看结论: composer outdated 是查看可更新包最准确的方式,但默认只显示有新版本的包(不包括已锁定版本),且不区分安全更新和功能更新——想全面掌握升级空间,必须加参数。
为什么 composer outdated 默认不显示所有包?
它只列出「当前 composer.lock 中安装的版本」与「仓库中最新稳定版」存在差异的包。如果某个包在 composer.json 中用固定版本(如 "monolog/monolog": "2.9.1")或带 ^ 但最新版仍在兼容范围内(如锁里是 2.9.1,最新是 2.9.2),它默认不显示——因为 Composer 认为“无需更新”。
实操建议:
- 加
--all参数强制列出所有已安装包,并标注是否为最新版:composer outdated --all - 加
--direct只看composer.json显式声明的包(排除依赖树里的间接依赖) - 加
--minor或--patch限制只显示小版本或补丁级更新,避免意外升到不兼容的大版本
composer outdated 和 composer update --dry-run 有什么区别?
前者是「静态比对」:读取 composer.lock 和 Packagist 元数据,不解析约束逻辑;后者是「模拟执行」:实际运行依赖求解器,考虑 require-dev、平台配置、conflict 等全部规则。
常见错误现象:某包在 outdated 里显示可升到 v3.0.0,但 update --dry-run 却报冲突——说明该版本与其他依赖不兼容,或被 platform 配置(如 PHP 版本)挡住了。