yii2 的 actions() 方法仅用于将 url 路径映射到继承自 yii\base\action 的独立动作类，不写业务逻辑、非路由入口；复用性高、逻辑重或需测试隔离时应优先使用独立 action 而非内联 actionxxx()。
Yii2 的 actions() 方法是用来注册“独立动作类”（custom Action classes）的，不是写业务逻辑的地方，也不是路由配置入口——它只干一件事：把某个 URL 路径映射到一个继承自 Action 的类上。
为什么不能直接在控制器里写 actionXXX？
当某段逻辑需要被多个控制器复用（比如统一的验证码生成、错误页渲染、API 标准返回封装），或者逻辑太重、测试不便、职责不清时，硬塞进 actionXxx() 方法里会导致控制器膨胀、难以维护。而 actions() 返回的数组，就是告诉框架：“这个 action ID 对应哪个独立类，参数怎么传”。
- 控制器本身不处理请求逻辑，只做路由分发
- 每个独立 Action 类必须继承
yii\base\Action并实现run()方法 - 框架通过
createAction()先查actions()数组，再 fallback 到actionXXX内联方法
常见的内置 Action 类怎么配
Yii2 提供了一批开箱即用的 Action 类，直接配进 actions() 就能用，不用自己写：
-
'error' => ['class' => 'yii\web\ErrorAction', 'view' => 'error']：自动捕获 404/500 错误并渲染视图 -
'captcha' => ['class' => 'yii\captcha\CaptchaAction', 'fixedVerifyCode' => YII_ENV_TEST ? 'testme' : null]：生成图形验证码，访问/site/captcha即生效 -
'index' => ['class' => 'yii\rest\IndexAction', 'modelClass' => 'app\models\User']：RESTful 场景下快速提供列表接口
注意：class 值支持完整命名空间，也支持路径别名（如 @app/actions/TestAction），但别名必须已注册。
自定义 Action 类最容易踩的坑
写自己的 TestAction 时，以下几点不注意就会 404 或报错：
- 类必须继承
yii\base\Action，不是Controller，也不能漏掉run()方法 - 命名空间要和文件物理路径严格一致，比如文件在
frontend/actions/TestAction.php，那 namespace 就得是frontend\actions - 配置里的
class值写错大小写或拼写（如frontend\Actions\TestActionvsfrontend\actions\TestAction）会导致类找不到 - 想在
run()里调用$this->controller->render()是可以的，但若返回纯数据（如 API），记得设\Yii::$app->response->format = \yii\web\Response::FORMAT_JSON
参数传递和运行时行为差异
actions() 配置项里传的键值对，会以 public 属性方式注入到 Action 实例中；而 URL query string 里的参数（如 ?id=123）则由框架自动传给 run() 方法的参数列表：
public function run($id = null, $type = null) {
// $id 和 $type 来自 URL 参数
// $this->param1 来自 actions() 配置里的 'param1' => 'xxx'
}
这意味着：URL 参数用于动态上下文（如资源 ID），配置参数用于固定行为开关（如是否启用缓存、模板名）。混用或错位会导致逻辑错乱，尤其在 RESTful + 过滤器组合场景下。
真正复杂的是 Action 类内部对 $this->controller 和 $this->id 的依赖——它们决定了当前请求归属哪个控制器、哪个 action ID，影响日志、权限判断甚至模块嵌套行为。这些细节不显眼，但一旦跨模块复用 Action，就很容易因 $this->controller->module 链路断裂而出错。
