ThinkPHP中间件如何实现功能及配置步骤详解？

本文共计855个文字，预计阅读时间需要4分钟。

ThinkPHP中间件不是可有可无的装饰，而是控制请求生命周期关键开关——它能在请求到达控制器前做鉴权、解析参数、记录日志，也能在响应发出前修改头信息、压缩内容、注入数据。

中间件类文件放哪、怎么命名才不报 Class not found

类必须放在 app/middleware/ 目录下，文件名和类名严格一致（比如 CheckAuth.php 里必须定义 class CheckAuth），命名空间固定为 app\middleware，不能写成 App\Middleware 或 app\Middlewares。

• 多应用模式下路径是 app/{app_name}/middleware/，别漏掉应用名
• 类需继承 think\Middleware 或实现 __invoke 方法
• 如果用了 Swoole / RoadRunner，确保类已提前加载（避免运行时 autoload 失败）

全局中间件为什么没生效

app/middleware.php 是唯一入口，它必须存在、必须返回数组、且不能有 echo 或 return null 等干扰语句。