conflict 字段用于主动声明当前包与某些版本的其他包互不兼容，使 Composer 在安装或更新时检测到冲突即报错终止；其值为版本约束，如 "monolog/monolog": ">=2.0.0"。
在 composer.json 中使用 conflict 字段，是为了**主动声明当前包与某些版本的其他包互不兼容**，从而让 Composer 在安装或更新时直接报错，阻止不安全或不可用的组合被引入项目。
conflict 字段的作用和触发时机
conflict 不是“建议不装”，而是“禁止共存”。只要 Composer 检测到当前依赖图中同时存在你声明的冲突包（且版本匹配），就会中断安装或更新，并抛出清晰的错误提示，例如：
基本写法：指定包名和版本约束
在 composer.json 的根级别添加 conflict 对象，键为包名，值为版本约束（支持通配符、比较符等）：
"conflict": {
"monolog/monolog": ">=2.0.0",
"phpunit/phpunit": "<9.0.0 || >=10.0.0",
"ext-sodium": "<1.0.0"
}
- 上面表示：本包不兼容
monolog/monolog2.x 及以上、phpunit/phpunit小于 9 或大于等于 10、以及sodium扩展低于 1.0.0 版本 - 版本写法与
require完全一致，支持^、~、!=、||等逻辑 - 可以冲突扩展（
ext-xxx）、PHP 版本（php）、甚至自己（如"my/package": ">=3.0.0"表示不兼容自身未来大版本）
典型适用场景
-
API 破坏性变更后封禁旧版依赖：比如你重构了对
guzzlehttp/guzzle的调用方式，只支持 v7+，就加"guzzlehttp/guzzle": " -
避免运行时冲突：两个包都注册同名全局函数或重写同一类，可提前用
conflict阻断 -
限制 PHP 或扩展版本：如强制要求
ext-mbstring存在且不低于某版本，否则直接失败 -
防止误升级导致崩溃：某次发布明确不支持 Laravel 10，就在
conflict中写"laravel/framework": "^10.0"
注意事项和常见误区
-
conflict是“硬性拦截”，不会降级或跳过 —— 它让 Composer 主动拒绝解析出有问题的锁文件 - 它只影响当前包的安装上下文；如果你的包被其他项目 require，对方仍需满足你的 conflict 规则，否则安装失败
- 不要用
conflict替代require或replace；它不提供功能，只做排除 - 测试时务必运行
composer update --dry-run验证冲突规则是否按预期触发
基本上就这些。合理用好 conflict，能帮你把兼容性问题挡在构建之前，比 runtime 报错更早、更明确、更可控。
