PHP中间件拦截HTTP请求需在路由分发前执行预处理逻辑并终止流程;裸PHP须手动控制入口(如index.php),框架中需正确注册(如Laravel的$middlewareGroups[‘api’])且handle()中不调用$next($request)才能真正拦截。
PHP中间件怎么拦截 HTTP 请求(不是 CLI)
PHP 本身没有原生中间件概念,所谓“中间件拦截”,实际依赖框架(如 Laravel、Slim、Symfony)或手动在入口层(public/index.php)做请求预处理。直接在裸 PHP 中写“中间件”必须自己控制执行流——核心是**在路由分发前插入逻辑,并决定是否继续向下执行**。
常见错误:把 include 一个校验文件当成中间件;没 return 或 exit 导致后续逻辑仍执行;混淆了「拦截」和「重定向」——拦截成功应终止响应,而非跳转。
- 必须在所有路由匹配和控制器调用之前运行
- 推荐统一入口:所有请求经由
index.php,在此处加载中间件链 - 用函数返回
false或直接exit/http_response_code(403)终止流程,不要只 echo 提示 - Laravel 的
app/Http/Middleware下类需在Kernel.php中注册,否则不生效
Laravel 中间件如何真正阻止服务调用
很多人写了中间件但发现接口仍被调用,问题往往出在注册位置或闭包写法。Laravel 的中间件只有绑定到具体路由(或路由组)才会触发,全局中间件($middleware)默认不包含 API 路由——因为 api 中间件组默认使用 throttle:api 和 bindings,不自动包含 web 中的中间件。
- API 请求要拦截,必须显式加到
app/Http/Kernel.php的$middlewareGroups['api']里 - 中间件
handle()方法中,不调用$next($request)就不会进入后续逻辑——这是拦截的关键动作 - 别在
handle()里用redirect()拦截 API 请求:前端拿不到 403,应返回 JSON + 状态码,例如:return response()->json(['error' => 'Forbidden'], 403); - 注意中间件顺序:鉴权中间件必须在参数验证中间件之前,否则非法用户可能绕过检查直接触发服务逻辑
用 PSR-15 标准手写轻量中间件(兼容 Slim/FastRoute)
如果你不用 Laravel,又想保持可移植性,PSR-15 是最稳妥的选择。它定义了 process() 方法签名,支持堆叠调用,且多数现代微框架原生支持。
立即学习“PHP免费学习笔记(深入)”;