讲师中心 微信公众号
AI工具推荐 视频效率加速

Yii2过滤器Filter与中间件链式调用【原理】

秋萱同学_5905

秋萱同学_5905

发布时间:2026-07-10 17:30:49

|

999人浏览过

|

来源于php中文网

原创

Yii2过滤器是基于事件的单向监听机制,非Laravel式中间件链;其本质为继承ActionFilter的行为类,通过监听EVENT_BEFORE_ACTION/after_action事件执行beforeAction(可中断)和afterAction(不可中断),多个过滤器按声明顺序同序执行前后逻辑。

yii2过滤器filter与中间件链式调用【原理】

Yii2 没有 Laravel 那种标准的中间件链(middleware pipeline),它的“过滤器”不是靠 $next($request) 逐层传递,而是基于控制器生命周期事件触发的、**单向监听式执行**。理解这点,才能避免照搬 Laravel 写法导致静默失效。

Filter 的本质是 ActionFilter 行为

Yii2 的过滤器(如 AccessControl、VerbFilter)都继承自 \yii\base\ActionFilter,它本身是一个 Behavior(行为),被挂载到控制器上,监听 EVENT_BEFORE_ACTION 和 EVENT_AFTER_ACTION 两个事件。

  • 不是“链”,没有 $next 回调;而是“钩子”,框架在动作执行前后自动触发对应方法
  • beforeAction() 返回 false 会中断动作执行,返回 true 才继续——这是唯一“拦截”方式
  • afterAction() 无法阻止动作执行,只能处理结果或修改响应
  • 多个过滤器按声明顺序依次执行 beforeAction,再按**相同顺序**执行 afterAction(不是逆序)

FilterChain 是历史遗留概念,已不推荐直接使用

早期 Yii2 版本(如 2.0.0–2.0.6)支持手动定义 filterAccessControl() 方法并调用 $filterChain->run(),但该机制已被弃用:

Yii Framework 2.0.51
Yii Framework 2.0.51

Yii Framework 2.0.51 官方 Basic 应用模板,适合旧项目兼容、升级验证和开发测试。

下载
  • CFilterChain 类属于旧版抽象,现代项目中基本见不到
  • 当前官方文档和核心组件(如 AccessControl)全部走 Behavior + Event 模式
  • 若在控制器里写 public function filters() 返回数组,底层仍会自动包装成 Behavior 实例

所谓“链式调用”其实是错觉

有人看到多个过滤器生效,误以为是链式调用,实际是:

  • 框架初始化控制器时,把所有声明的 Filter 注册为 Behavior
  • 请求进入后,逐一调用每个 Behavior 的 beforeAction(),任一返回 false 就终止流程
  • 动作执行完,再逐一调用每个 Behavior 的 afterAction(),顺序与 before 一致
  • 不存在跨过滤器的数据透传(如 Laravel 中 $request->attributes 可被下个中间件读取)

想模拟链式?得自己封装逻辑

如果真需要类似 Laravel 的 $next 流程(比如记录耗时、动态改请求参数),可行做法是:

  • 写一个自定义 Behavior,在 beforeAction 中修改 $action->controller->view 或设置全局状态(如 Yii::$app->params['filter_context'])
  • 用事件代替:在 EVENT_BEFORE_ACTION 发送自定义事件,其他模块监听并处理,再由主逻辑决定是否继续
  • 避免在 web/index.php 层硬编码中间件类——Yii2 不识别 ['middleware' => [...]] 这类配置,会直接忽略

热门AI工具

更多
Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

相关专题

更多
PHP Yii框架专题
PHP Yii框架专题

本专题专注于PHP主流框架Yii的应用,系统讲解MVC架构、路由机制、数据库操作、表单处理、安全验证与RESTful API 开发等核心内容。通过电商网站、后台管理系统与内容管理平台等实战项目,帮助学员快速掌握Yii框架的开发技巧与实战经验。

2830

2025.09.04

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

120

2026.09.23

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

60

2026.09.23

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

40

2026.09.23

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

40

2026.09.22

Conan二进制包配置指南
Conan二进制包配置指南

本专题介绍Conan根据操作系统、编译器、架构和构建类型生成二进制包的方法,讲解Profile、Settings、Options及Package ID的作用,帮助管理不同平台和编译环境下的包版本。

40

2026.09.22

Conan私有仓库搭建教程
Conan私有仓库搭建教程

本专题系统的讲解Conan私有仓库的搭建流程,涵盖仓库服务部署、存储目录配置、用户认证、权限划分和远程地址添加,并介绍内部C++依赖包的上传、下载及版本维护方法。

40

2026.09.22

loomy官网入口地址合集
loomy官网入口地址合集

本专题汇总了 Loomy 桌面 AI 助理的官方入口地址合集及使用指南。提供 macOS 与 Windows 客户端下载 。Loomy 是讯飞推出的桌面级 AI 工作搭子,支持文件整理、数据分析、网页操作及通过飞书/钉钉远程操控电脑,助你高效完成本地办公任务 。

40

2026.09.22

NumPy常见函数使用方法
NumPy常见函数使用方法

本专题整理 NumPy 常见函数使用方法相关教程,覆盖函数大全、参数用法、数组运算、统计聚合、排序处理、where 条件筛选、linspace 创建数列等常用场景,帮助读者快速掌握 NumPy 函数调用思路和实际数据处理技巧。

60

2026.09.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Yii2中文手册
Yii2中文手册

共0课时 | 0.6万人学习

thinkphp基础介绍和yii2基础介绍
thinkphp基础介绍和yii2基础介绍

共10课时 | 2.5万人学习

Yii2框架基础视频教程
Yii2框架基础视频教程

共22课时 | 2.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn