使用 composer show --tree 或 composer show -t 查看依赖树,需在项目根目录执行;composer 2.5+ 用 -t 替代 --tree,配合 --no-dev 可过滤开发依赖,composer why --tree 定位冲突源头,composer graph 支持可视化依赖图。

如果您在 ThinkPHP 项目中需要理清各扩展包之间的依赖关系,但执行命令后无法获得清晰的树状结构,则可能是由于 Composer 版本不兼容、未指定包名或未在正确目录下运行所致。以下是查看 ThinkPHP 项目 Composer 依赖树的具体方法:
一、使用 composer show --tree 查看完整依赖树
该命令直接读取 vendor/ 和 composer.lock 中已安装依赖的真实快照,适用于 Composer 2.2.0 至 2.4.x 版本,输出为缩进式文本树,可直观反映 ThinkPHP 及其扩展(如 topthink/think-queue、topthink/think-swoole)的嵌套层级关系。
1、打开终端,进入 ThinkPHP 项目的根目录(即包含 composer.json 的目录)。
2、执行命令:composer show --tree。
3、若需聚焦于核心框架,可限定范围:composer show --tree topthink/framework。
4、如需排除开发依赖以避免干扰生产环境分析,添加 --no-dev 参数:composer show --no-dev --tree。
二、使用 composer show -t 替代方案(适配 Composer 2.5+)
Composer 2.5.0 及以上版本已彻底移除 --tree 参数,此时必须使用短参数 -t;该命令功能等价于旧版 --tree,且稳定性更高,特别适合 ThinkPHP 项目中因版本升级导致原命令失效的场景。
1、确认当前 Composer 版本:composer --version,若显示 ≥ 2.5.0,则启用此方案。
2、在项目根目录执行:composer show -t .(点号代表当前项目,用于展开全部依赖)。
3、针对特定 ThinkPHP 扩展包,例如查看 think-orm 的下游依赖:composer show -t topthink/think-orm。
4、若需过滤开发依赖,注意 --no-dev 必须置于 -t 前:composer show --no-dev -t .。
三、使用 composer why --tree 追溯依赖源头
当 ThinkPHP 项目中某个包(如 psr/log 或 symfony/console)引发版本冲突时,仅知其被引入不够,必须定位到项目自身 composer.json 中哪一行 require 声明了它;--tree 参数可展开完整路径,直至末尾出现 your-project-name dev-main 或 [dev] 标记。
工作流任务拆解与模型编排技能。使用场景:(1) 收到复杂工作任务需要拆解为可执行步骤,(2) 需要为不同步骤选择最合适的模型,(3) 需要跟踪工作流进度和模型使用情况,(4) 长时间任务卡住需要问题诊断和解决方案。
1、执行命令:composer why --tree psr/log,观察输出末尾是否指向 topthink/framework 或你自己的项目名。
2、若怀疑是开发依赖引入,保留 [dev] 标识以识别来源:composer why --tree phpunit/phpunit。
3、对于未安装但需预判依赖链的包,加 --remote 参数远程查询:composer why --remote --tree league/flysystem。
四、使用 composer show --who 查找直接依赖者
该命令不解析嵌套关系,而是直接扫描所有已安装包的 require 和 require-dev 字段,精准列出显式声明某包的上游包,适用于快速判断 ThinkPHP 扩展是否主动引入了冲突组件(如 overtrue/laravel-wechat 对 psr/log 的硬依赖)。
1、运行:composer show --who psr/log,结果中若出现 topthink/think-swoole,说明该扩展是直接声明方。
2、排除开发依赖以聚焦生产环境:composer show --who --no-dev psr/log。
3、若返回为空,不代表无人使用——可能通过虚拟包提供(如 "provide": {"psr/log": "*"}),此时应回查全局依赖树:composer show -t . 并搜索 psr/log。
五、使用 composer graph 生成可视化依赖图
当文本树难以辨识复杂嵌套(例如多个 ThinkPHP 插件交叉依赖同一 Symfony 组件)时,需借助图形化工具;composer graph 基于 Graphviz 渲染有向图,可清晰展示依赖流向与冲突节点。
1、全局安装图形化插件:composer global require baethon/composer-graph。
2、确保系统已安装 graphviz:macOS 执行 brew install graphviz;Ubuntu/Debian 执行 sudo apt install graphviz;Windows 需从官网下载并勾选「Add Graphviz to the system PATH」。
3、在 ThinkPHP 项目根目录运行:composer graph --format=png --output=deps.png,生成 PNG 图像文件。
4、若需排除开发依赖影响图形简洁性,添加 --no-dev:composer graph --no-dev --format=png --output=prod-deps.png。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










