composer prohibits 用于分析为何某个包无法安装，它通过检查当前项目的依赖关系和版本约束，列出阻止目标包安装的冲突来源。例如执行 composer prohibits monolog/monolog:2.0 可查看具体是哪些已安装或声明的包及其版本限制导致该版本无法引入。基本语法为 composer prohibits [options] [:]，常见用法包括检查 symfony/http-foundation:6.0 或 laravel/framework:10.x 的安装障碍，还可使用 --no-dev 忽略开发依赖以聚焦生产环境冲突。输出结果会显示如“my/package 1.0 requires symfony/http-foundation ^5.4”等阻止规则，表明现有依赖仅兼容旧版本。建议结合 --with-dependencies 查看间接依赖冲突，或使用 --no-plugins 排除插件干扰，帮助快速定位并解决依赖不兼容问题。
当你在使用 Composer 安装某个包时，遇到提示该包无法安装，可能是由于依赖冲突。这时你可以使用 composer prohibits 命令（在较新版本中也支持 composer why-not）来分析为什么某个包不能被安装。
这个命令能帮助你快速定位是哪个已安装或已声明的依赖阻止了目标包的安装，从而节省调试时间。
composer prohibits 是什么？
composer prohibits composer.json、已安装的依赖以及版本约束，告诉你哪些包或版本规则导致目标包无法被引入。
例如：
composer prohibits monolog/monolog:2.0
会显示为什么 monolog/monolog 的 2.0 版本不能被安装。
如何使用？
基本语法：
composer prohibits [options]
常见用法示例：
- composer prohibits symfony/http-foundation:6.0 — 查看为何不能安装 Symfony HTTP Foundation 6.0
- composer prohibits laravel/framework:10.x — 检查 Laravel 10 无法安装的原因
- composer prohibits --no-dev guzzlehttp/guzzle:7.5 — 在不考虑 dev 依赖的情况下分析冲突
输出结果解读
执行命令后，Composer 会返回类似下面的信息：
my/package 1.0 requires symfony/http-foundation ^5.4 laravel/framework 9.0 requires symfony/http-foundation ^5.4
这意味着你的项目中某些包只兼容 Symfony 5.4，而你尝试安装的包需要 Symfony 6.0 或更高，因此产生冲突。
每条输出说明了一个“禁止”规则来源：某个已存在的包或当前项目要求了与目标版本不兼容的版本约束。
实用建议
使用 prohibits 时可以配合以下技巧：
- 先确认你想安装的包和版本是否正确，比如拼写、版本号是否存在
- 尝试加上
--with-dependencies查看间接依赖的冲突 - 使用
--no-plugins或--no-scripts排除插件干扰（用于调试） - 如果项目长期未更新，考虑先升级主要框架以打开兼容性路径
基本上就这些。通过 composer prohibits 能快速定位依赖障碍，避免手动翻找 composer.json 中的版本限制，提升问题排查效率。
