罗罗编程学习记录
本页内容 展开查看

06.5.3.5 控制器动作与过滤器

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.3 Yii

06.5.3.5-001 Controller 的职责与动作命名约定是什么?

一句话结论

控制器负责编排请求:读取输入、调用服务、选择响应;动作用 action 前缀的公共方法表达,路由动作标识由前缀后的 Pascal/kebab 形式映射得到。

概念解释

控制器不承载业务规则与数据访问细节,只做请求层协调。动作方法名 actionView 对应路由 view;多个词动作按框架约定转换,目录与命名空间由模块上下文解析。

原理流程

  1. 路由解析到控制器类与动作标识。
  2. 框架实例化控制器,解析动作方法/动作类。
  3. 动作读取输入、调用服务、返回响应数据。

代码或图示

class PostController extends yii\web\Controller
{
    public function actionView(int $id): mixed
    {
        return $this->render('view', ['model' => $this->findModel($id)]);
    }
}

常见误区

  • 在控制器里写 SQL 与校验规则:职责越界,后续测试与复用困难。
  • 动作方法声明为 protected/private:路由无法调用,视为动作不存在。

追问

  • 动作方法返回字符串会怎样?答:作为响应主体处理;视图渲染与 JSON 格式化按 response 配置决定,具体规则以版本为准。
  • 控制器基类提供哪些通用能力?答:布局渲染、重定向、返回响应、过滤器挂载等 Web 控制器基础能力。

06.5.3.5-002 内联动作如何与路由映射?

一句话结论

内联动作是控制器内的 actionXxx 公共方法;路由动作标识去掉 action 前缀并按大小写/分隔符约定匹配,方法参数按路由与请求参数绑定。

概念解释

actionCreate 对应动作 create;动作段为空时执行 $defaultAction。内联动作适合简单控制器逻辑,复杂可复用动作应抽为独立动作类。

原理流程

  1. 路由动作标识进入控制器。
  2. 框架拼接 action 前缀查找方法。
  3. 找到后绑定参数并调用。

代码或图示

// 路由 post/create → actionCreate()
public function actionCreate(): mixed
{
    $model = new \app\models\Post();
    // 表单加载与保存
    return $this->render('create', ['model' => $model]);
}

常见误区

  • 动作标识含驼峰却写成连字符:映射规则不匹配会 404,需确认框架对大小写与分隔符的转换约定。
  • 把非动作公共辅助方法也加 action 前缀:被误暴露为可路由动作。

追问

  • 同一控制器多个动作共享前置逻辑放哪?答:放 beforeAction、行为或服务方法,避免每个动作复制前置代码。
  • 默认动作如何定义?答:设置控制器 $defaultAction 属性,未给动作段时执行该方法。

06.5.3.5-003 actions() 外部动作映射如何使用?

一句话结论

控制器重写 actions() 返回动作标识到独立动作类配置的映射;未在 actionXxx 中实现的动作由映射表解析为外部 Action 对象。

概念解释

当动作逻辑复杂或需要跨控制器复用时,抽成独立 Action 类;actions() 登记标识与类/配置,框架实例化动作类并调用其 run()。控制器保持精简,动作能力可复用。

原理流程

  1. 路由动作标识未命中内联方法。
  2. 查 actions() 映射得到动作类定义。
  3. 实例化 Action,绑定控制器后执行 run()。

代码或图示

public function actions()
{
    return [
        'upload' => \app\actions\UploadAction::class,
        'error' => yii\web\ErrorAction::class,
    ];
}

常见误区

  • 内联方法与 actions 映射同名:优先顺序需以框架实现为准,避免两套实现混淆。
  • 动作类配置缺 class:映射无法实例化,动作解析失败。

追问

  • 动作类能否接收配置参数?答:actions 映射值可用配置数组传入动作属性,具体形式以框架文档为准。
  • 独立动作与控制器方法如何选择?答:跨控制器复用、逻辑较重选 Action;单一页面的简单编排保留内联动作。

06.5.3.5-004 独立动作类 yii\base\Action 的结构是什么?

一句话结论

独立动作继承 yii\base\Action,实现 run() 方法;持有 controller 引用,动作标识存在 id 属性,框架在执行前完成控制器绑定。

概念解释

Action 是可调度单元,run() 签名可声明参数,绑定规则与内联动作一致。动作类可定义自己的过滤器与权限检查,复用给多个控制器。

原理流程

  1. 定义类继承 Action,实现 run()。
  2. actions() 登记标识与类。
  3. 框架创建动作实例、绑定 controller,调用 run(参数)。

代码或图示

class UploadAction extends yii\base\Action
{
    public function run(): mixed
    {
        $file = $this->controller->request->files;
        // 处理上传并返回响应
        return $this->controller->render('upload');
    }
}

常见误区

  • 动作类构造函数依赖未由容器注入:独立动作由框架实例化,构造注入能力有限,协作者应从控制器/服务获取。
  • run() 直接输出 echo:响应仍应交由 response 组件统一处理。

追问

  • Action 如何访问控制器属性?答:通过 $this->controller 引用;动作基类在绑定后提供该属性。
  • Action 能否附加行为?答:Action 基类能力以版本为准;横切逻辑优先放控制器过滤器或服务层。

06.5.3.5-005 控制器目录与命名空间如何组织?

一句话结论

控制器目录与模块 controllerNamespace 对应,命名空间前缀映射到目录;多模块按 modules/<名称>/controllers/ 分层,避免控制器类名冲突。

概念解释

应用控制器默认在 app\controllers 命名空间;模块控制器在模块子命名空间。Composer psr-4 映射保证按命名空间定位文件,目录层级必须与路由层级一致。

原理流程

  1. 模块/应用声明控制器命名空间。
  2. 路由控制器标识转为类名。
  3. 按命名空间自动加载定位控制器文件。

代码或图示

controllers/
├── SiteController.php
├── PostController.php
└── admin/
    └── UserController.php   # app\modules\admin\controllers\UserController

常见误区

  • 目录放错层级导致类找不到:命名空间与目录不一致是最常见 404 原因。
  • 不同模块取同名控制器类:命名空间隔离后不冲突,但路由前缀必须区分。

追问

  • 控制器类名后缀有强制约定吗?答:默认约定后缀 Controller;后缀约定可通过控制器工厂/命名规则调整,基础项目遵循默认约定。
  • 控制器能否按功能再分子目录?答:可以,对应路由段与命名空间同步加深。

06.5.3.5-006 behaviors() 在控制器中如何挂载过滤器?

一句话结论

控制器重写 behaviors() 返回过滤器配置数组;过滤器作为行为附加到控制器,在动作执行前后按顺序介入请求处理链。

概念解释

过滤器本质是控制器行为,实现 beforeAction/afterAction 介入点。常见内置过滤器包括访问控制、动词过滤;自定义过滤器继承对应过滤器基类,登记到 behaviors 生效。

原理流程

  1. 控制器 behaviors() 列出过滤器标识与配置。
  2. 动作执行前依次调用过滤器 beforeAction。
  3. 动作执行后依次调用 afterAction。

代码或图示

public function behaviors()
{
    return [
        'verbFilter' => [
            'class' => yii\filters\VerbFilter::class,
            'actions' => ['delete' => ['POST', 'DELETE']],
        ],
    ];
}

常见误区

  • 把过滤器当中间件写在路由配置里:2.x 过滤器挂在控制器 behaviors,路由只做解析。
  • 过滤器顺序依赖数组直觉:执行顺序以 behaviors 排列与过滤器实现为准,关键顺序需测试确认。

追问

  • 过滤器能否跨控制器复用?答:可以,过滤器类独立编写,多个控制器 behaviors 引用同一类。
  • 控制器行为与 AR 行为机制相同吗?答:都基于 Behavior 基类与事件/钩子机制,挂载对象分别是控制器与组件。

06.5.3.5-007 AccessControl 规则如何配置?

一句话结论

AccessControl 通过 rules 数组声明 allow/deny 规则,匹配条件包括 roles、verbs、ips、用户访客身份;规则按顺序判定,首个匹配规则决定允许或拒绝。

概念解释

allow 为 true 表示允许,false 表示拒绝;roles 对应用户身份(如 @ 登录、? 访客),verbs 限定方法,ips 限定来源 IP。未被任何规则允许时默认拒绝。

原理流程

  1. 过滤器遍历规则。
  2. 规则条件匹配当前用户、方法、IP。
  3. 首个匹配规则给出放行/拒绝;拒绝时走拒绝回调或异常。

代码或图示

public function behaviors()
{
    return [
        'access' => [
            'class' => yii\filters\AccessControl::class,
            'rules' => [
                ['allow' => true, 'roles' => ['@']],
                ['allow' => false, 'roles' => ['?']],
            ],
        ],
    ];
}

常见误区

  • 只写 allow 规则不兜底:未匹配规则的身份行为取决于默认拒绝约定,应显式拒绝访客。
  • 把数据级权限写进 AccessControl:过滤器只做访问控制入口,行级/资源级授权在服务层判断。

追问

  • 拒绝后如何跳转登录?答:AccessControl 可配置拒绝回调,未登录访客通常重定向登录页或返回 403,具体配置以过滤器文档为准。
  • roles 除 @/? 外能否用权限名?答:可配合 RBAC 权限/角色名;需用户组件与权限体系就绪,具体键名以版本为准。

06.5.3.5-008 VerbFilter 如何做动词过滤?

一句话结论

VerbFilter 按动作名限定允许的 HTTP 方法;请求方法不符时拒绝,防止 GET 触发写操作,是 CSRF 与动作语义的基础防护之一。

概念解释

配置键为动作标识,值为允许方法数组;未列入配置的动作不限制。VerbFilter 与路由规则 verb 可叠加,动作层防护保证即使绕过路由规则仍受限。

原理流程

  1. 过滤器读取当前动作标识。
  2. 查配置中允许方法列表。
  3. 当前方法不在列表则拒绝请求。

代码或图示

'verbs' => [
    'class' => yii\filters\VerbFilter::class,
    'actions' => [
        'delete' => ['POST', 'DELETE'],
        'update' => ['POST', 'PUT'],
        'index' => ['GET'],
    ],
],

常见误区

  • 写动作只靠 VerbFilter 防 CSRF:动词过滤不替代 CSRF 令牌校验,两者职责不同。
  • 动作标识与配置键不一致:新动作未被限制,绕过方法约束。

追问

  • 方法不符返回什么状态?答:通常返回 405 或按错误处理器配置输出;具体状态码与响应格式以过滤器实现为准。
  • HEAD/OPTIONS 如何处理?答:如需兼容可在允许列表显式加入,浏览器预请求按中间件/过滤器处理。

06.5.3.5-009 beforeAction($action) 钩子如何短路?

一句话结论

控制器 beforeAction($action) 返回 false 表示中断后续动作执行;过滤器链中任一过滤器判定不放行也会短路,响应由拒绝逻辑生成。

概念解释

beforeAction 在动作方法调用前执行,可做初始化、权限预检查、参数校验;返回 false 后框架不再调用动作,需自行准备响应。返回 true 继续执行链。

原理流程

  1. 动作调度前进入 beforeAction。
  2. 过滤器与控制器钩子依次判定。
  3. 返回 false 短路,否则执行动作。

代码或图示

public function beforeAction($action)
{
    if (!parent::beforeAction($action)) {
        return false;
    }
    if ($this->action->id === 'preview' && !$this->isAllowed()) {
        throw new yii\web\ForbiddenHttpException();
    }
    return true;
}

常见误区

  • 忘记调用 parent::beforeAction:过滤器链未走完,访问控制可能失效。
  • 返回 null/void 被当成 false:返回值语义必须显式为 true/false,短路条件要明确。

追问

  • beforeAction 中能拿到路由参数吗?答:动作对象绑定后可通过动作与请求读取参数;动作标识在 $action->id。
  • 短路后如何输出响应?答:抛 HTTP 异常交错误处理器,或直接设置 response 并返回 false 终止调度。

06.5.3.5-010 afterAction 后置处理做什么?

一句话结论

afterAction($action, $result) 在动作执行后介入,可统一改写返回结果、记录耗时、补充响应头;返回值作为最终结果继续进入响应管道。

概念解释

afterAction 与 beforeAction 成对出现,过滤器同样实现后置钩子。适合跨动作的统一结果包装、审计记录;不应在这里发起必须同步完成的重 I/O。

原理流程

  1. 动作执行得到结果。
  2. 过滤器与控制器 afterAction 依次处理结果。
  3. 改写后的结果交 response 格式化。

代码或图示

public function afterAction($action, $result)
{
    $result = parent::afterAction($action, $result);
    Yii::info("{$action->id} finished", 'controller');
    return $result;
}

常见误区

  • 在 afterAction 里改业务状态:动作已完成,后置逻辑不应承担写操作主流程。
  • 后置处理抛异常未捕获:响应阶段异常影响错误输出,应隔离预期内异常。

追问

  • afterAction 是否一定执行?答:beforeAction 短路时动作不执行,afterAction 链路是否触发取决于框架实现;关键清理逻辑应放在可靠位置。
  • 统一包装 JSON 响应放哪?答:可在 afterAction 或 response 格式化器中处理,API 项目优先用 response format 配置。

06.5.3.5-011 过滤器执行顺序与跨控制器复用如何安排?

一句话结论

过滤器按 behaviors 配置排列进入链,前置钩子按顺序执行、后置钩子逆序收尾;可复用过滤器类在多个控制器配置中引用,配置差异通过属性传入。

概念解释

顺序决定鉴权、日志、参数校验等切面的包裹关系:鉴权靠前,日志包裹全链。复用过滤器时把可变条件(动作白名单、角色)做成配置属性,不在过滤器内硬编码控制器名。

原理流程

  1. behaviors 数组登记过滤器与配置。
  2. beforeAction 按登记顺序调用。
  3. 动作执行后 afterAction 逆序调用。

代码或图示

// 顺序示意:访问控制 → 动词过滤 → 业务动作
public function behaviors()
{
    return [
        'access' => ['class' => AccessControl::class, /* rules */],
        'verb' => ['class' => VerbFilter::class, /* actions */],
    ];
}

常见误区

  • 日志过滤器排在鉴权之后:未授权请求不被记录,安全审计缺失。
  • 复用过滤器时复制粘贴整段配置:应抽公共配置片段或基类控制器统一引用。

追问

  • 全局过滤器如何落地?答:2.x 可在基类控制器 behaviors 中统一挂载,子控制器继承;3.0 对应全局 PSR-15 中间件。
  • 过滤器能否只对部分动作生效?答:配置中 actions 白名单/黑名单限定动作,未列入的动作不经过该过滤器特定逻辑。

06.5.3.5-012 动作返回值如何进入 Response 格式化?

一句话结论

动作返回数据后写入 response 的 data,按 response format(HTML/JSON/XML/RAW 等)格式化;视图渲染由 render() 完成,返回渲染后的主体字符串。

概念解释

HTML 动作通常 render 视图返回内容;API 动作返回数组/对象,JSON 格式化器转为 JSON 响应。动作也可直接返回 response 对象或调用 redirect/sendFile 终止常规流程。

原理流程

  1. 动作返回结果。
  2. 结果写入 response->data 或主体。
  3. 按 format 处理后 send 输出。

代码或图示

public function actionList()
{
    Yii::$app->response->format = yii\web\Response::FORMAT_JSON;
    return ['items' => $this->findLatest(), 'total' => 100];
}

常见误区

  • API 动作直接 echo JSON:绕过格式化器,状态码与头不受统一控制。
  • 同时 render 视图又返回数组:响应主体被后写覆盖,结果不可预期。

追问

  • format 常量有哪些?答:2.x 常见 FORMAT_HTML、FORMAT_JSON、FORMAT_XML、FORMAT_RAW、FORMAT_JSONP;具体列表以 Response 类文档为准。
  • 动作能否返回 Response 对象?答:可以,返回响应对象时框架直接采用,不再二次格式化。

06.5.3.5-013 动作参数如何与请求参数绑定?

一句话结论

动作方法同名参数按路由占位符与请求参数自动绑定;PHP 默认值作为缺省,类型声明参与校验;参数缺失或类型不符时按框架规则报错。

概念解释

路由规则捕获的命名参数与 GET/POST 参数都可作为动作入参来源。复杂输入(表单对象、文件)应在动作内通过 request 组件读取,不靠参数绑定。

原理流程

  1. 动作方法反射参数名。
  2. 从路由参数、请求参数取值。
  3. 类型转换/校验后调用动作方法。

代码或图示

public function actionView(int $id, int $page = 1)
{
    // $id 来自路由占位符,$page 来自 query,默认 1
}

常见误区

  • 参数类型不做约束:外部输入直接进入业务逻辑,应在动作层或表单模型校验。
  • 把整个请求对象声明为动作参数:绑定机制不识别超全局,应从 Yii::$app->request 读取。

追问

  • 路由参数与 query 同名谁优先?答:绑定优先级以框架实现为准,关键参数应显式从 request 读取避免歧义。
  • 数组参数如何绑定?答:动作参数声明为数组类型,请求参数按数组传入;复杂结构用表单模型接收更清晰。

06.5.3.5-014 模块控制器如何解析命名空间?

一句话结论

进入模块路由后,控制器类在模块 controllerNamespace 下解析;模块可覆盖默认命名空间,嵌套模块按层级拼接前缀。

概念解释

应用与模块各自声明控制器命名空间;路由模块段决定使用哪套前缀。类文件名与类名保持一致,psr-4 自动加载定位文件。

原理流程

  1. 路由首段匹配模块 ID。
  2. 模块实例化,读取控制器命名空间。
  3. 控制器标识拼前缀转为类名并加载。

代码或图示

namespace app\modules\admin\controllers;

use yii\web\Controller;

class UserController extends Controller
{
    public function actionIndex(): mixed
    {
        return $this->render('index');
    }
}

常见误区

  • 模块控制器忘记改命名空间:落在应用命名空间,模块路由解析不到。
  • 嵌套模块只改目录不改前缀:内层控制器被外层模块错误解析。

追问

  • 模块能否复用应用控制器?答:可继承应用基类控制器或共享抽象类,但路由解析仍按模块命名空间。
  • 控制器命名空间可配置吗?答:模块 controllerNamespace 属性可在配置中覆盖。

06.5.3.5-015 独立动作的 run() 与权限控制如何组织?

一句话结论

独立动作的权限检查可放在动作基类 beforeRun 一类钩子(以版本接口为准)或调用前的过滤器;动作类专注执行,鉴权仍应在控制器过滤器链前置完成。

概念解释

跨控制器复用动作时,各控制器通过过滤器声明自身权限;动作内部只做资源归属校验。避免把登录判断硬编码进动作类,否则复用方无法覆盖策略。

原理流程

  1. 控制器过滤器完成身份与角色判定。
  2. 动作 run() 执行业务。
  3. 资源归属检查在动作/服务层补充。

代码或图示

class DeleteAction extends yii\base\Action
{
    public function run(int $id): mixed
    {
        $model = $this->findOwnModel($id);
        // 归属校验通过后执行删除
        return $this->controller->redirect(['index']);
    }
}

常见误区

  • 动作类内直接读 Yii::$app->user 写死策略:复用方无法替换鉴权规则。
  • 跳过控制器过滤器只靠动作内检查:其他入口调用动作时可能漏检。

追问

  • Action 基类是否提供前置钩子?答:2.x Action 生命周期钩子以基类文档为准;不确定时在 run 开头做显式检查并标注待确认。
  • 动作如何返回 403?答:抛 ForbiddenHttpException,由错误处理器统一输出。

06.5.3.5-016 错误动作 errorAction 如何配置?

一句话结论

错误处理器可指定错误动作(如 site/error),异常发生后渲染错误页面或 JSON;动作内从 errorHandler 取得异常与当前响应状态。

概念解释

Web 应用统一错误出口避免每个控制器自行处理异常视图;API 模式下错误动作按 JSON 输出错误码与消息。错误动作本身要尽量独立,不依赖可能失败的业务组件。

原理流程

  1. 异常被 errorHandler 捕获。
  2. 按配置进入 errorAction 路由。
  3. 动作读取异常信息并渲染/序列化错误响应。

代码或图示

'components' => [
    'errorHandler' => [
        'errorAction' => 'site/error',
    ],
],

常见误区

  • 错误动作里再次触发数据库查询失败:异常被二次包裹,页面无法渲染。
  • 生产环境在错误动作展示完整堆栈:应按调试开关控制详细信息输出。

追问

  • API 异常走同一个 errorAction 吗?答:可按 response format 分支输出;也可由错误处理器直接序列化,实现方式以配置为准。
  • 错误动作能访问原始异常吗?答:从 errorHandler 组件取得异常对象;具体取值接口需对照版本文档确认。

06.5.3.5-017 鉴权失败的响应流程是什么?

一句话结论

未登录访客跳转登录页(Web)或返回 401/403(API);权限不足返回 403;异常由错误处理器转换为对应状态码与响应体,过滤器在动作前阻断执行。

概念解释

身份认证由 user 组件判定,授权规则由 AccessControl/RBAC 判定。未认证与未授权状态码不同:401 提示登录,403 表示已识别但无权访问。

原理流程

  1. 过滤器读取身份与规则。
  2. 未认证:重定向登录或 401。
  3. 已认证但无权:403,交错误处理器输出。

代码或图示

if (Yii::$app->user->isGuest) {
    return $this->redirect(Yii::$app->user->loginUrl);
}
throw new yii\web\ForbiddenHttpException('无权限访问');

常见误区

  • 401 与 403 混用:未登录应 401,登录后越权应 403,客户端处理逻辑不同。
  • 鉴权失败仍执行动作:过滤器未短路,动作内才拒绝,已产生副作用。

追问

  • API 无会话如何认证?答:通过 token 过滤器/用户组件身份识别,请求头携带凭据,方案以应用认证设计为准。
  • 登录页地址如何配置?答:user 组件 loginUrl 配置,未认证跳转目标取自该配置。

06.5.3.5-018 控制器如何瘦身,业务如何下沉 Service?

一句话结论

控制器只做输入接收、调用服务、组装响应;校验、领域规则、事务边界放到服务类,模型/仓储负责数据访问,使控制器薄而可测。

概念解释

典型分层:动作 → 应用服务(用例编排、事务)→ 领域模型/仓储 → 数据库。控制器不直接写事务、不拼装复杂业务规则;服务类可独立单元测试,不依赖 HTTP 请求。

原理流程

  1. 动作接收请求参数,构造表单/命令对象。
  2. 调用服务方法完成用例。
  3. 服务结果映射为视图数据或 API 响应。

代码或图示

// 控制器:编排
public function actionCreate()
{
    $form = new PostForm();
    $form->load(Yii::$app->request->post());
    $post = Yii::$container->get(PostService::class)->create($form);
    return $this->redirect(['view', 'id' => $post->id]);
}

常见误区

  • 服务类仍依赖 Yii::$app->request:脱离 HTTP 上下文后无法测试。
  • 多个控制器复制同一套编排:应下沉到服务,控制器只保留差异适配。

追问

  • 表单校验放哪一层?答:表单模型/验证器负责输入校验,服务层只接收已校验命令。
  • 事务边界划在服务还是控制器?答:服务层用例边界开启事务,保证多步写入一致。

06.5.3.5-019 Yii 3.0 中控制器动作与 PSR-15 中间件如何对照?

一句话结论

3.0 把 2.x 过滤器能力对应到 PSR-15 中间件链,动作/处理器是链末端单元;鉴权、CORS、日志等以独立中间件包裹处理器,控制器不再通过 behaviors 挂过滤器。

概念解释

2.x 的 beforeAction/afterAction 切面在 3.0 由中间件 process(请求, 处理器) 包裹实现;处理器接收 PSR-7 请求返回响应。控制器类仍可存在,但装配与调用走容器和路由。

原理流程

  1. 中间件链按序包裹处理器。
  2. 鉴权/日志中间件前置介入。
  3. 末端处理器执行业务并返回 Response。

代码或图示

Middleware A → Middleware B → Handler(动作)
  ←──────────── Response ────────────

常见误区

  • 把 2.x behaviors 过滤器配置原样迁移:3.0 过滤器基类与挂载点已不同,需改写为中间件。
  • 业务规则写进中间件:中间件只做横切,用例逻辑留在处理器/服务。

追问

  • 3.0 还有控制器基类吗?答:有轻量处理器/控制器约定,具体基类与能力以应用模板和 yiisoft 包文档为准。
  • 中间件顺序如何测试?答:以单元/集成测试验证鉴权先于业务执行,响应经过各中间件改写。

06.5.3.5-020 常见误区:beforeAction 返回值与过滤器放置位置

一句话结论

最常见错误是忘记返回 true、beforeAction 未调父类、过滤器挂在错误层级、写操作动作缺少动词与 CSRF 防护、权限检查滞后到动作内部。

概念解释

评审控制器时核对:继承父类钩子返回值、behaviors 过滤器顺序、动作动词约束、鉴权前置、业务下沉清单。每个写动作明确允许方法与令牌校验方式。

原理流程

  1. 核对 beforeAction/afterAction 是否调用 parent 并显式返回布尔。
  2. 核对过滤器配置与动作白名单。
  3. 核对写动作的 CSRF 与动词防护。

代码或图示

// 自检清单(示意)
// [x] parent::beforeAction 已调用并返回 true
// [x] 鉴权过滤器在动作执行前
// [x] delete/update 限定 POST/PUT/DELETE
// [ ] 业务事务已下沉服务层

常见误区

  • beforeAction 里直接输出内容后不返回 false:框架继续执行动作,产生双重输出。
  • 把 AccessControl 挂到子控制器而基类已有全局规则:两套规则叠加,预期放行可能被另一套拒绝。

追问

  • 如何快速定位过滤器未生效?答:检查 behaviors 是否重写覆盖、动作是否在白名单、父类钩子是否中断链。
  • 控制器测试如何模拟请求?答:构造 request/response 组件或调用服务层;动作编排逻辑尽量薄,便于脱离 Web 测试。