Laravel 8.15（PHP 8.0.2）安装Composer包触发依赖版本冲突报错

冲突根因说明 #

• Composer的依赖解析为全量校验机制：执行新包安装时，会遍历composer.lock中所有已锁定包的平台版本要求，并非仅校验待安装包本身的依赖规则。
• 当前报错的三类版本不匹配，全部来自项目已锁定的存量旧包，这些旧包的PHP版本约束仅覆盖7.x分支，与当前环境的PHP 8.0.2不兼容，最终导致无法生成可安装的依赖集合。
• 安装失败后Composer自动回滚composer.json、composer.lock为操作前状态是内置防护逻辑，不会破坏原有项目配置。

生产环境可落地的解决步骤 #

• 前置操作：备份项目根目录下的composer.json、composer.lock文件，防止操作失误无法恢复初始状态
• 逐版本升级存量不兼容依赖（以下推荐的升级版本均匹配Laravel 8.15、PHP 8.0.2的运行要求，升级改动最小）：
• 升级spatie/laravel-permission：执行composer require spatie/laravel-permission:"^4.0"，该版本分支移除了PHP版本上限，完整兼容PHP 8.0，且对Laravel 8.x版本的配置无破坏性变更
• 升级yajra/laravel-datatables-oracle：执行composer require yajra/laravel-datatables-oracle:"^9.18.0"，v9.18.0是兼容PHP 8.0的最低迭代版本，原有使用逻辑无需调整
• 升级barryvdh/laravel-dompdf及关联依赖：执行composer require barryvdh/laravel-dompdf:"^1.0.0" dompdf/dompdf:"^2.0.0"，该版本组合移除了PHP 7.1的版本约束，可正常在PHP 8.0环境运行
• 待上述存量包升级完成、无版本冲突提示后，执行composer require hnhdigital-os/laravel-number-converter:"^1.1"即可完成目标扩展包的安装

临时调试用兜底方案 #

如果项目为本地临时调试状态，暂时无法完成存量包升级，可在安装命令中添加参数跳过平台版本校验，命令为：
composer require hnhdigital-os/laravel-number-converter:"^1.1" --ignore-platform-reqs

• 风险提示：该操作会绕过所有PHP版本、扩展的兼容性校验，可能触发运行时错误，严禁在生产环境使用*

操作参考：升级存量包的过程中若出现其他依赖冲突，可按Composer输出的提示逐一定位匹配兼容版本，无需一次性修改所有依赖配置。

内容的提问来源于stack exchange，提问作者BkenMedia