CakePHP Bake插件函数声明不兼容，克隆仓库运行报错求助

同事克隆代码仓库后，运行自定义插件的bake命令时触发PHP致命错误：

PHP Fatal error: Declaration of OurPlugin\Command\ModelCommand::findBelongsTo(Cake\ORM\Table $model, array $associations): array must be compatible with Bake\Command\ModelCommand::findBelongsTo(Cake\ORM\Table $model, array $associations, ?Cake\Console\Arguments $args = null): array in C:\Users\colleague_name_here\Downloads\xampp_php81\htdocs\OurApp\plugins\OurPlugin\src\Command\ModelCommand.php on line 334

本地现有代码无此问题，但新克隆代码可复现。项目composer.json中依赖配置为：

"cakephp/bake": "^2.3",

当前vendor目录中Bake\Command\ModelCommand的findBelongsTo函数定义：

public function findBelongsTo(Table $model, array $associations, ?Arguments $args = null): array

自定义插件中的函数定义：

public function findBelongsTo(Table $model, array $associations): array

查看cakephp/bake 2.3.0版本的该函数定义为：

public function findBelongsTo(Table $model, array $associations): array

原因分析 #

问题出在Composer的版本约束^2.3上：

• ^2.3表示允许安装2.3.0及以上、3.0.0以下的所有小版本
• cakephp/bake在2.3.x的后续小版本（比如2.3.1或更高）中，给findBelongsTo函数新增了第三个可选参数?Arguments $args = null
• 你本地的vendor目录是旧的2.3.0版本，但新克隆代码执行composer install时拉取了2.3.x的更新版本，导致父类函数签名变更，子类的自定义实现因参数不兼容触发报错

解决办法 #

• 锁定精确版本：把composer.json里的依赖改成"cakephp/bake": "2.3.0"，然后执行composer update cakephp/bake，确保团队所有人使用完全相同的版本
• 同步函数签名：修改自定义插件中的findBelongsTo方法，添加第三个可选参数，和父类保持一致：

  public function findBelongsTo(Table $model, array $associations, ?Cake\Console\Arguments $args = null): array
  

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