如何使用\Yii::$classMap重写/扩展命名空间方法（以Controller为例）

你的思路方向是对的，利用Yii的classMap来替换原生控制器类，但有几个关键细节需要调整才能正常工作，下面是完整的正确实现步骤：

1. 编写自定义的yii\web\Controller类 #

在common/classMaps/Controller.php中创建文件，注意不要直接继承原yii\web\Controller（否则会因为classMap替换导致循环继承），直接继承它的父类\yii\base\Controller，同时保持命名空间为yii\web，这样才能被classMap正确替换：

namespace yii\web;

// 直接继承原web\Controller的父类base\Controller，避免循环引用
class Controller extends \yii\base\Controller
{
    public function beforeAction($action)
    {
        // 先执行父类的beforeAction基础逻辑
        $result = parent::beforeAction($action);
        
        // 在这里添加你的自定义逻辑，比如权限校验、全局日志、参数预处理等
        // 示例：记录当前访问的动作
        // \Yii::info("执行动作：{$action->controller->id}/{$action->id}", 'access');
        
        return $result; // 必须返回布尔值，true继续执行动作，false终止
    }

    // 这里可以正常调用原yii\web\Controller的所有方法，因为我们覆盖的就是这个类
}

2. 正确配置classMap（关键：加载顺序） #

在backend/web/index.php中，必须在加载Yii核心文件之前配置classMap，否则原生的yii\web\Controller已经被自动加载，classMap替换不会生效。正确的代码顺序如下：

// 首先加载composer自动加载器
require __DIR__ . '/../../vendor/autoload.php';

// 在这里配置classMap，替换原生类
\Yii::$classMap['yii\web\Controller'] = '@common/classMaps/Controller.php';

// 然后加载Yii核心文件
require __DIR__ . '/../../vendor/yiisoft/yii2/Yii.php';

// 加载应用配置
$config = require __DIR__ . '/../../config/backend/web.php';

// 运行应用
(new yii\web\Application($config))->run();

3. 编写业务控制器 #

在backend/controllers/MyController.php中正常继承yii\web\Controller即可，此时继承的就是你自定义的那个类：

namespace backend\controllers;

class MyController extends \yii\web\Controller
{
    public function actionIndex()
    {
        // 执行此动作前，会先触发你自定义的beforeAction逻辑
        return $this->render('index');
    }
}

额外注意事项 #

• 确保@common别名在应用配置中已正确定义（默认Yii2模板中已经配置）。
• 如果需要在多个应用（如frontend、backend）共享这个自定义控制器，只需在每个应用的入口文件中添加相同的classMap配置即可。
• 若要阻止某个动作执行，只需在beforeAction中返回false，Yii会自动终止后续流程。

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