如何在项目中使用fork的Laravel框架并解决Composer依赖报错

问题场景 #

为Laravel框架贡献代码时，完成仓库fork、新建特性分支、功能代码编写后，新建空Laravel项目测试功能环节遇到依赖安装阻碍。
修改项目composer.json添加自定义仓库配置：

...
"repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/trckster/framework"
    }
],
"require": {
    ...
    "laravel/framework": "dev-feat/show-fields-difference-for-similar-results",
    ...
},
...

执行composer update后返回依赖解析错误：

Your requirements could not be resolved to an installable set of packages.

  Problem 1
    - illuminate/support[v6.0.0, ..., v6.19.1] require php ^7.2 -> your php version (8.0.19) does not satisfy that requirement.
    - illuminate/support[v7.0.0, ..., v7.28.4] require php ^7.2.5 -> your php version (8.0.19) does not satisfy that requirement.
    - illuminate/support[v8.0.0, ..., v8.11.2] require php ^7.3 -> your php version (8.0.19) does not satisfy that requirement.
    - Root composer.json requires laravel/framework dev-feat/show-fields-difference-for-similar-results -> satisfiable by laravel/framework[dev-feat/show-fields-difference-for-similar-results].
    - laravel/tinker[v2.7.0, ..., 2.x-dev] require illuminate/support ^6.0|^7.0|^8.0|^9.0 -> satisfiable by illuminate/support[v6.0.0, ..., 6.x-dev, v7.0.0, ..., 7.x-dev, v8.0.0, ..., 8.x-dev, v9.0.0-beta.1, ..., 9.x-dev].
    - Only one of these can be installed: illuminate/support[v6.0.0, ..., 6.x-dev, v7.0.0, ..., 7.x-dev, v8.0.0, ..., 8.x-dev, v9.0.0-beta.1, ..., 9.x-dev], laravel/framework[dev-feat/show-fields-difference-for-similar-results]. laravel/framework replaces illuminate/support and thus cannot coexist with it.
    - Root composer.json requires laravel/tinker ^2.7 -> satisfiable by laravel/tinker[v2.7.0, v2.7.1, v2.7.2, 2.x-dev].

核心诉求为调整配置完成依赖安装，测试开发的自定义功能。

问题原因 #

报错本质是两个问题叠加：

1. Composer拉取dev开发分支时，无法自动识别该分支对应的正式版本号，因此解析其他依赖（比如laravel/tinker）的illuminate/support版本约束时，会遍历所有历史版本匹配，最终选中了不支持本地PHP8.0的低版本illuminate包。
2. laravel/framework包会替换所有独立的illuminate/*包，二者不能共存，版本解析规则不一致时就会触发冲突。

解决步骤 #

• 确认特性分支的基础版本
  打开你fork的framework仓库根目录的composer.json，查看切分支时基于的Laravel版本：如果是基于Laravel 9开发，对应PHP版本约束为^8.0，和本地8.0.19匹配；如果是基于Laravel 8早期版本/7/6开发，要么把分支rebase到支持PHP8的对应框架最新小版本，要么切换本地PHP版本到对应要求的版本。同时保证新建的测试空Laravel项目初始版本和fork分支的基础大版本一致，不要跨大版本测试。
• 给dev分支配置版本别名
  修改composer.json中laravel/framework的版本约束，用as给开发分支绑定对应正式版本号，让Composer能正确识别依赖版本匹配规则。比如基于Laravel 9.0开发，配置修改为：

  "require": {
      ...
      "laravel/framework": "dev-feat/show-fields-difference-for-similar-results as 9.0.0",
      ...
  }
  

  别名版本号替换为实际基于的框架tag版本即可，比如基于Laravel 8.83开发就写as 8.83.0。
• 带指定参数执行更新命令
  执行更新时指定只更新laravel/framework相关依赖，减少无关包的版本解析干扰：

  composer update laravel/framework --with-all-dependencies
  

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