中间件 · SwooleDistributed 3.X

# 中间件 [TOC] SD框架引入了中间件过程，消息的传递流程如下。 >message->pack->middleware1(before)->middleware2(before)->...->route->controller->...->middleware2(after)->middleware1(after) ## SD自带的中间件 ### Middleware 中间件最基础的类，开发中间件继承Middleware。 * before_handle 中间件before过程 * after_handle 中间件after过程 * interrupt 中断中间件 ### HttpMiddleware http使用的基础中间件。一般开发http中间件请继承HttpMiddleware，提供了常用的命令。 ### NormalHttpMiddleware 这个中间件是提供给Http使用的，它具备的功能是提供了默认主页，404页面，文件后缀查询。 ``` $config['ports'][] = [ 'socket_type' => PortManager::SOCK_HTTP, 'socket_name' => '0.0.0.0', 'socket_port' => 8081, 'route_tool' => 'NormalRoute', 'middlewares' => ['MonitorMiddleware', 'NormalHttpMiddleware'] ]; ``` 在ports配置中请务必携带NormalHttpMiddleware。 ### MonitorMiddleware 效率中间件，将记录接口的运行时间，并写入日志。 ## 配置中间件作用于每一个端口配置，也就是说不同的端口可以单独配置中间件。中间件的执行严格按照数据的顺序执行。 ``` $config['ports'][] = [ 'socket_type' => PortManager::SOCK_HTTP, 'socket_name' => '0.0.0.0', 'socket_port' => 8081, 'route_tool' => 'NormalRoute', 'middlewares' => ['MonitorMiddleware', 'NormalHttpMiddleware'] ]; ``` 如上图执行顺序为MonitorMiddleware(before)->NormalHttpMiddleware(before)->...->NormalHttpMiddleware(after)->MonitorMiddleware(after). ## 注意 before流程中只要有一个中间件调用了interrupt方法，那么后续的中间件都不会被执行。 after流程中会忽略interrupt。 ## interrupt 一旦在before阶段触发了interrupt，那么将跳过Route，Controller的处理直接进入after的操作。 ## before 可以在after阶段修改信息流。比如NormalHttpMiddleware中就修改了request中的值，导致后续的路由发生改变。 ``` if (is_string($index)) { $www_path = $this->getHostRoot($host) . $this->getHostIndex($host); $result = httpEndFile($www_path, $this->request, $this->response); if (!$result) { $this->redirect404(); } else { $this->interrupt(); } } elseif (is_array($index)) { $this->request->server['path_info'] = "/" . implode("/", $index);//这里修改了request的值 } else { $this->redirect404(); } ``` ## after after一般用于统计，比如MonitorMiddleware的作用就是统计各个接口的执行信息，并写入日志。 ## context 贯穿整个流程的context，是个上下文，context在整个流程中共享。任意一个地方修改context都会影响到整个流程。可以通过context给后续流程传递信息。