composer中如何检查哪些包可以升级_composer check-updates用法【详解】

4次阅读

composer 没有 composer check-updates 命令,应使用 composer outdated 查看可升级包,默认显示当前版本约束下可安全升级的依赖,加 –all 显示所有新版(含需改 composer.json 的),加 –direct 仅检查直接依赖,带 ! 标记表示存在安全漏洞;执行前务必用 –dry-run 模拟升级,确认变更内容与 BC 风险。

composer中如何检查哪些包可以升级_composer check-updates用法【详解】

Composer 没有内置的 composer check-updates 命令,这个命令不存在 —— 运行它会报错 Command "check-updates" is not defined

composer outdated 用来查看可升级的包

这是 Composer 官方提供的、最直接替代“检查更新”的命令。它列出所有已安装但有新版可用的依赖(包括语义化版本范围内和范围外的)。

  • 默认只显示 当前 composer.json 版本约束下可安全升级 的包(即满足 ^1.2.0 这类约束的最新兼容版)
  • --all 参数会显示所有有新版的包,哪怕需要修改 composer.json 中的版本号(比如从 ^2.1 升到 ^3.0
  • --direct 只检查你直接声明在 composer.json 中的包,忽略依赖的依赖
  • 输出中带 ! 标记的表示存在安全公告(CVE),应优先处理
composer outdated --all --direct

composer update 的行为与 –dry-run 关键作用

真正执行升级前,用 --dry-run 模拟升级过程,能清晰看到哪些包会被更新、是否涉及 major 版本跃迁、是否有冲突。

  • composer update --dry-run:模拟全局更新,不改 composer.lock
  • composer update vendor/package --dry-run:只模拟单个包升级
  • 注意:如果 composer.json 里写的是 "monolog/monolog": "2.0.*" 这种松散约束,--dry-run 可能仍会升级到 2.9.0;但如果是 "2.0.0" 锁死版本,则不会动
  • 输出里出现 DowngradingUpgrading 后跟 major 字样,意味着 BC break 风险,不能无脑运行

第三方工具:composer-require-checker 和 dependabot 不是替代品

有人误以为 composer-require-checker 能查更新,其实它只检查代码中 usenew 的类是否在 require 中声明,和版本无关。而 Dependabot 是 gitHub/gitlab 的自动 PR 工具,它底层调用的仍是 composer outdated + 解析策略,不是本地命令。

  • 若想自动化检测,推荐在 CI 中加一步:composer outdated --direct --minor-only --no-dev(仅检查小版本更新,避免意外升 major)
  • 注意 --minor-only 是 Composer 2.2+ 才支持的参数,旧版本不识别
  • CI 中不要用 --all,否则每次都会因有大版本更新而失败,失去意义

常见错误:把 require-dev 包当成线上风险

很多开发者看到 phpunit/phpunit 可升级就立刻 update,但它是 require-dev,不影响生产环境运行时。是否升级取决于你的测试基础设施是否兼容新版本。

  • 区分 --with-dependencies(默认开启)和 --no-update-with-dependencies:后者只升指定包,不连带升级其子依赖,适合排查问题
  • 升级前务必确认 composer.lock 是否提交 —— 没锁文件的项目,不同人 install 出来的依赖可能完全不同
  • 升级后至少跑一次 composer validatecomposer dump-autoload -o,避免 autoloader 错乱

真正要警惕的不是“能不能升”,而是“升完会不会崩”。outdated 只告诉你“有新版”,--dry-run 才告诉你“升了会怎样”——这两步缺一不可,跳过任何一步都容易在线上触发未预期的异常。

text=ZqhQzanResources