composer outdated是唯一正确命令,它只读检查哪些包有新版本可更新,不修改任何文件;默认仅显示直接依赖,加--all可查全部依赖,含间接依赖和被replace覆盖的包。

composer update 会直接升级,怎么只看有哪些包能更新
想确认哪些依赖有新版本、但又不想立刻升级,composer outdated 是唯一正确命令。它不修改 composer.json 或 vendor/,只做只读检查。
常见错误是误用 composer update --dry-run:它确实模拟更新,但输出冗长、难以快速识别“哪些包有更新”,且会触发 autoload 重建和脚本执行(哪怕没改文件),实际体验反而更重。
-
composer outdated默认只显示有新版的包(已满足最小稳定要求) - 加
--all可显示所有包(含当前已是最新版的),方便核对锁定状态 - 加
--direct仅显示composer.json中直接声明的依赖,排除层层嵌套的间接依赖 - 加
--minor-only或--patch-only可按语义化版本规则过滤(如只看小版本或补丁更新)
为什么 composer show -l 不是好选择
composer show -l 本质是列出本地已安装包及其版本,并非“对比远程仓库找更新”。它不访问 Packagist,也不校验 composer.lock 是否过期,结果和 outdated 完全不同。
典型误导场景:某个包在 composer.lock 中锁的是 2.1.0,而 Packagist 已发布 2.2.0,show -l 仍只显示 2.1.0,毫无提示作用。
-
composer show是“当前装了啥”,composer outdated是“能升到啥” -
show -l的-l参数指 “list”,不是 “latest” —— 这个命名容易引发误解 - 若网络不通或 Packagist 临时不可达,
outdated会明确报错,而show -l照常返回旧数据,掩盖问题
CI/CD 脚本里怎么安全判断是否有可更新包
自动化流程中需要根据“是否存在可更新依赖”做分支处理(比如有更新则发通知,无更新则跳过),不能依赖人眼扫输出。关键点是用退出码 + --format=json。
-
composer outdated --no-ansi --format=json | jq -e 'length > 0':有更新时jq返回 0,无更新返回 4,适合if判断 - 纯 shell 场景可用
composer outdated --quiet:有更新时退出码为 1,无更新为 0(注意:这和直觉相反,务必实测验证) - 避免用
grep匹配文字输出,因outdated在无更新时不输出任何内容,但不同 Composer 版本对空输出的处理略有差异
更新列表里显示的版本号到底对应什么
每行格式通常是:vendor/package installed-version latest-version type。其中 latest-version 不一定代表 Packagist 上最高版本,而是 Composer 根据你当前 composer.json 中的约束(如 "^2.0")和 minimum-stability 配置筛选出的“合法最新版”。
- 如果某包最新版是
3.0.0,但你的composer.json写着"vendor/package": "^2.0",那latest-version显示的仍是2.x系列的最高小版本(如2.5.1) - 若
minimum-stability是stable,而远程只有dev-master或beta版本,则不会出现在列表中 - 加
--direct后看到的latest-version才真正决定composer update vendor/package会升到哪——间接依赖的“最新”可能被直接依赖的版本范围卡住
outdated 的结果高度依赖 composer.lock 是否存在且未被手动修改。如果项目从未运行过 composer install,或 lock 文件被删,它会退回到仅基于 composer.json 解析,此时显示的“已安装版本”会是 ?,且部分逻辑失效。











