中间件

路由是整个框架最核心的功能之一，最后执行会根据路由地址操作最终的回调处理，而这个回调处理本身就是一个中间件处理模块之一。

当控制器配置中间件之后，执行会先将配置的中间件全部调用完，最终落地到控制器方法中，由开发者最终处理。

中间件配置

操作步骤仅需三步:

  • 新建中间件
  • 注册中间件到配置文件
  • 添加中间到路由器
  1. <?php
  3. return [
  4.     // some code...
  5.     /**
  6.      * Http middleware
  7.      */
  8.     'middleware' => [
  9.         'foo' => Bar::class,
  10.     ],
  11. ];

添加到路由中

  1. route()->post('/', 'IndexController@sayHello')->withMiddleware('basic.auth');

自定义中间件

实现自己的中间件，只需要实现小部分代码，就能够完成一个简单的中间件处理。

  1. <?php
  3. namespace FastD\Auth;
  5. use FastD\Middleware\DelegateInterface;
  6. use FastD\Middleware\Middleware;
  7. use Psr\Http\Message\ResponseInterface;
  8. use Psr\Http\Message\ServerRequestInterface;
  9. use FastD\Http\Response;
  11. class BasicAuth extends Middleware
  12. {
  13.     /**
  14.      * @param ServerRequestInterface $serverRequest
  15.      * @param DelegateInterface $delegate
  16.      * @return ResponseInterface
  17.      */
  18.     public function handle(ServerRequestInterface $serverRequest, DelegateInterface $delegate)
  19.     {
  20.         if (/* logic */ true) {
  21.             $delegate->process($serverRequest);
  22.         }
  24.         return new Response('hello');
  25.     }
  26. }

中间件调度中，推荐返回 Psr\Http\Message\ResponseInterface，每个中间件都需要遵循的规定。

实现原理可以参考: PSR15

下一节: 授权