CakePHP 3.x/4.x 如何在Command文件夹下创建子文件夹存放命令

CakePHP 3.8、4.0版本默认不支持直接在Command目录下创建子目录存放命令，框架原生的扫描逻辑仅会遍历Command根目录下的.php文件，自动跳过所有子目录。

如果需要实现子目录分类存放命令，可以通过以下两种方案实现：

方案1：手动注册命令（适合命令数量较少的场景） #

1. 先调整子目录下命令的命名规则，符合PSR-4规范：
   目录结构调整为：

   ├─ src/
   │  ├─ Command/
   │  │  ├─ FirstFolder/
   │  │  │  ├─ TestCommand.php
   │  │  ├─ SecondFolder/
   │  │  │  ├─ TestCommand.php
   

   对应FirstFolder/TestCommand.php的命名空间为App\Command\FirstFolder，类名为TestCommand，正常继承CakePHP的Command基类即可。
2. 在src/Application.php的console方法中手动注册子目录下的命令：

   public function console(\Cake\Console\CommandCollection $commands)
   {
       parent::console($commands);
       
       // 注册子目录命令，第一个参数为命令调用名
       $commands->add('first_folder:test', \App\Command\FirstFolder\TestCommand::class);
       $commands->add('second_folder:test', \App\Command\SecondFolder\TestCommand::class);
       
       return $commands;
   }
   

   注册完成后即可通过bin/cake first_folder:test执行对应命令。

方案2：自定义递归扫描逻辑（适合命令数量较多的场景） #

如果子目录和命令数量较多，不想逐一手动注册，可以自行实现递归扫描Command目录的逻辑：

1. 递归遍历src/Command目录下所有后缀为Command.php的文件
2. 根据文件路径拼接出完整的类名（符合PSR-4命名空间规则）
3. 批量将类注册到CommandCollection中即可

注意事项 #

• 所有子目录下的命令类必须严格遵循PSR-4自动加载规范，命名空间与目录结构一一对应
• 可以给命令类设置$defaultName属性自定义调用名，避免注册时命名冲突

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