Phroute 不内置中间件机制，需手动在 dispatch() 前统一执行中间件数组，通过返回值（null 继续、非 null 终止）控制流程，禁止在路由闭包中直接 return 退出链。
Phroute 中间件怎么注册才生效
Phroute 本身不内置中间件机制，所谓“中间件”得靠手动在路由回调里调用，或者封装一层调度逻辑。直接往 Phroute\Router 实例上塞中间件方法会报错——它压根没这个接口。
常见错误现象：Call to undefined method Phroute\Router::middleware()，或路由函数里逻辑重复、耦合严重，比如每个 GET 都手动写一遍鉴权和日志。
- 必须自己实现“前置/后置钩子”，推荐在路由分发前统一处理：先执行中间件数组，再调用目标控制器方法
- 注册位置只能在
$router->dispatch()调用之前，不能在addRoute()时“绑定”到某条路由上（Phroute 不支持） - 若用 PSR-7 或自定义 Request/Response 对象，中间件函数签名得保持一致，比如
function ($request, $next)，否则$next()调用会出错
怎么在路由执行前后加通用逻辑（如鉴权、日志）
本质是拦截 $router->dispatch() 的返回值，并在调用实际路由闭包前/后插入代码。Phroute 返回的是一个可调用的闭包，不是直接执行结果，这点容易误解。
使用场景：登录态校验、请求耗时统计、API 响应头统一设置、参数预处理（如 JSON body 解析）。
立即学习“PHP免费学习笔记（深入）”；
- 不要试图修改
Phroute\Router源码，而是包装它的dispatch()方法 - 前置逻辑放在闭包执行前，后置逻辑需捕获返回值并处理（比如给
Response加Content-Type） - 注意异常穿透：中间件里
throw异常后，后续中间件和路由都不会执行，但得确保错误能被外层捕获，否则 500 静默失败 - 示例片段：
function wrapWithMiddleware($router, $middlewares) { return function ($method, $uri) use ($router, $middlewares) { $response = null; foreach ($middlewares as $mw) { $result = $mw($_SERVER, function() use ($router, $method, $uri) { return $router->dispatch($method, $uri); }); if ($result !== null) { $response = $result; break; } } return $response ?? $router->dispatch($method, $uri); }; }
为什么 Phroute 的路由闭包里不能直接 return 退出中间件链
因为 Phroute 的路由定义只是注册，真正执行靠 dispatch() 返回的闭包；而这个闭包一旦被调用，就直接运行到底，没有“中断当前中间件、跳过后续”的原生语义。
常见错误现象：写了 if (!auth()) return new Response('401', 401);，结果页面空白或报 Cannot modify header information —— 原因是响应已输出，但后续中间件还在继续执行，又尝试设 header。
- 必须让中间件之间通过返回值通信：约定返回
null表示继续，返回非null（如Response对象）表示终止链 - 所有中间件要检查上一个中间件的返回值，而不是依赖
return自动跳出 - 别在中间件里直接 echo/print_r，Phroute 不接管输出缓冲，容易破坏响应格式
性能和兼容性要注意什么
每次请求都遍历中间件数组并逐个调用，如果中间件里有 I/O（如查 Redis、读文件），会明显拖慢首字节时间。Phroute 本身轻量，但中间件写不好就成了瓶颈。
- 避免在中间件里做同步网络请求；鉴权尽量用内存缓存（如
$_SESSION或 APCu） - PHP 版本兼容性没问题（Phroute 支持 7.2+），但注意某些中间件用到的函数（如
getallheaders()）在 CLI 模式下不可用，本地测试时容易漏掉 - 如果项目后期要换框架（如 Laravel 或 Slim），现在写的中间件很难复用——Phroute 的无上下文设计导致中间件强依赖全局变量或手工传参
最麻烦的其实是调试：Phroute 不提供中间件执行顺序的 trace，出问题只能靠 var_dump 插桩，而且顺序错一点就全链失效。动手前先想清楚哪些逻辑真需要“中间件”，哪些其实放 index.php 开头更简单。
