Yii2：如何创建无需控制器名称的模块控制台命令？

刚好之前研究过Yii2控制台命令的简化配置，你说的这种默认./yii module_name/command/sub-command的格式确实有点繁琐，想省略控制器名直接用操作名的话，有几个实用的办法：

方法1：给模块控制台控制器设置别名路由 #

• 打开你模块的Module.php文件，在init()方法里配置控制台的控制器映射，把目标控制器直接绑定到模块名上，这样调用时就不需要写控制器ID了。
• 举个实际例子：假设你的模块叫tools，控制台控制器是BackupController，里面有actionRun()操作。修改init()方法如下：

public function init()
{
    parent::init();

    // 把模块名直接映射到对应的控制台控制器
    \Yii::$app->controllerMap['tools'] = [
        'class' => 'app\modules\tools\console\BackupController',
    ];
}

配置完成后，你就可以用./yii tools/run来执行操作，不用再写tools/backup/run了。

方法2：利用控制台路由规则重写 #

• 如果你需要更灵活的路由匹配（比如多个控制器都要简化），可以在控制台应用的配置文件（一般是console/config/main.php）里添加路由规则：

'components' => [
    'urlManager' => [
        'class' => 'yii\console\UrlManager',
        'rules' => [
            // 规则：模块名+操作名 → 模块名/控制器名/操作名
            '<module:\w+>/<action:\w+>' => '<module>/backup/<action>',
        ],
    ],
],

这个规则会自动把./yii tools/run解析成tools/backup/run，完全满足你的简化需求。

方法3：直接创建根级控制台控制器 #

• 如果你的模块控制台命令不需要严格的模块隔离，也可以直接在项目根目录的console/controllers下创建一个和模块同名的控制器，比如ToolsController，把原来模块控制器里的操作逻辑移过来。
• 这样直接执行./yii tools/run就能调用对应操作，彻底绕开模块控制器的层级限制，适合简单场景。

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