ThinkPHP使用MVC架构之中间件应用实践【高阶用法】-ThinkPHP-PHP中文网

中间件不是mvc第四层，而是横切请求生命周期的增强机制；它嵌入在路由解析后、控制器执行前及视图渲染后，可提前拦截或事后收尾，支持路由级、控制器级配置，能直接返回响应终止流程，并通过request/response间接影响模型与视图，但不可替代业务逻辑或引入耗时操作。

thinkphp使用mvc架构之中间件应用实践【高阶用法】

ThinkPHP 的 MVC 架构本身已清晰划分职责，但中间件不是 MVC 的“第四层”，而是横切在请求生命周期中的增强机制——它不破坏 M/V/C 的分工，却能精准干预每个环节的执行条件与上下文。

中间件如何嵌入 MVC 请求流

在 ThinkPHP 中，一次典型请求流程是：HTTP → 路由解析 → 中间件链（前置）→ 控制器执行 → 模型调用 → 视图渲染 → 中间件链（后置）→ 响应返回。中间件并不替代控制器逻辑，而是提前“铺路”或事后“收尾”。比如登录校验中间件在控制器前拦截未授权请求，日志中间件在视图渲染后记录耗时，二者都不碰模型数据或模板代码。

路由级中间件最常用：仅对某组 URL 生效，如 Route::get('admin/*', 'Admin/Index/index')->middleware('checkRole')
控制器级中间件更聚焦：在控制器类中声明 protected $middleware = ['AuthMiddleware', 'LogRequest'];，比全局配置更轻量
注意：中间件执行顺序严格依赖注册顺序，靠前的中间件先执行，也先结束（类似洋葱模型）

绕过控制器的中间件实战场景

有些需求根本不需要走控制器，中间件可直接终结请求。例如接口签名验证失败时立即返回 401，或维护期间统一返回静态提示页。

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

直接返回响应对象：return json(['code'=>401, 'msg'=>'签名无效']); 或 return view('maintain');
避免后续中间件和控制器执行：只要 return 了响应，Pipeline 就中断，后续 handle 不再调用
适合做网关级逻辑：如 IP 黑名单、请求频率限制、API 版本路由分发

中间件与模型/视图的协同技巧

中间件虽不直接操作模型或视图，但可通过 Request/Response 对象或应用容器间接影响它们。

向控制器注入运行时参数：在中间件中设置 $request->withAttr('user', $userInfo)，控制器里就能用 $this->request->attr('user') 获取
统一修改响应头：后置中间件中调用 $response->header('X-Response-Time', microtime(true) - START_TIME)
动态切换视图主题：根据用户偏好或设备类型，在中间件中绑定模板变量或设置视图配置