composer why vendor/package-name是最可靠、无需配置的反向依赖命令,基于composer.lock回溯安装原因;加--tree可展开完整路径,但需确保包已安装,否则返回空。

composer depends 命令根本不存在,除非你手动启用实验功能
执行 composer depends monolog/monolog 报错 “Command ‘depends’ is not defined”,不是你装错了 Composer,而是它在 2.4+ 之前压根没这个命令。即使你用的是 2.4+,它默认也关闭——必须先运行 composer config experimental.show-depends true 才能激活,且该配置只对当前项目生效。
启用后,depends 仍只查「直接 require 了目标包」的顶层包,不递归、不分 require 和 require-dev、也不显示版本约束。比如它告诉你 laravel/framework 依赖 monolog/monolog,但不会说约束是 "^2.0" 还是 "~1.8",更不会展开 laravel/framework → symfony/console → psr/log → monolog/monolog 这类路径。
真正可靠、无需配置的反向依赖命令是 composer why
composer why vendor/package-name 是 Composer ≥ 2.2 的原生命令,基于 composer.lock 回溯安装原因,结果稳定、语义清晰。它不依赖实验开关,也不需要提前安装插件。
- 不加参数:只输出一级来源,例如
laravel/framework 9.52.0 requires monolog/monolog (^2.0) - 加
--tree:展开完整路径,看清它是怎么被“带进来”的(如通过symfony/console中转) - 加
--dev:显式包含require-dev引入的链路(否则默认忽略) - 加
--no-dev:强制排除开发依赖,避免误判上线环境
注意:why 查的是已安装状态,如果 vendor/monolog/monolog 不存在,它一定返回空——哪怕 composer.json 里写了,也得先 composer install 或 composer require。
--tree 输出层级浅 ≠ 没被嵌套,而是它处于依赖图底部
当你对 react/event-loop 运行 composer why --tree,输出可能只有两三级,比如:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
your/project
└── react/http 1.10.0
└── react/event-loop 1.5.0
这不是命令失效,恰恰说明 react/event-loop 是 ReactPHP 生态的基础包:几乎所有组件都直接依赖它,但它自己不依赖其他 ReactPHP 包。所以“上游链条”到此为止。真要查深层间接引入,应该反过来查它的使用者——比如 composer why --tree react/http,才可能暴露出某条 dev-only 路径绕道拉入了它。
常见误判是看到缩进少就以为“没人用它”,其实它可能被十几个包同时直连依赖,只是 why --tree 不会把所有并列路径堆在一起显示。
输出结构里容易忽略的关键细节
composer why --tree 默认输出是纯文本缩进,但每个层级实际携带三类关键信息,人工扫一眼容易漏:
- 包名和版本号(如
laravel/framework 10.48.12)—— 版本来自composer.lock,不是composer.json的约束 - 箭头右侧的
requires或requires (dev)—— 明确区分生产/开发依赖类型,不加--dev就看不到后者 - 缩进最深的那行,就是你查的目标包;它上面每一级,都是真实安装路径中的父级,不是 composer.json 里的理想声明
如果你发现某包只出现在 require-dev 下(比如被 phpunit/phpunit 拉入),但项目上线时又报错说找不到类,大概率是 autoload 配置或 classmap 生成时没覆盖到 dev 包——这时候 --tree 提示的上下文,比单纯看 composer.json 更接近真实运行现场。










