中间件 Middleware

    只需要实现了 接口均为一个合法的中间件，其中 process() 方法为该中间件逻辑处理方法, 可以参考 Swoft 项目呢 app/Middlewares/ 目录下的文件, 比如 app/Middlewares/ActionTestMiddleware:

    使用

    1. // 全局中间件配置: app/config/beans/base.php
    2. return [
    3.     ...
    4.     'serverDispatcher' => [
    5.         'middlewares' => [
    6.             \Swoft\View\Middleware\ViewMiddleware::class,
    7.             \Swoft\Session\Middleware\SessionMiddleware::class,
    8.         ]
    9.     ],
    10.     ...
    11. ];

    通过 @Middleware 和 @Middlewares, 可以很方便的配置中间件到当前的 Controller 和 Action 内

    • 当将此注解应用于 Controller 上，则作用域为整个 Controller
    • 将此注解应用于 Action 上，则作用域仅为当前的 Action
    • @Middleware 用于配置单个中间件
    • @Middlewares 显而易见的是用于配置一组 ，按照定义顺序依次执行, 使用参考 app/Controllers/MiddlewareController.php

    构造一个新的 Response 对象直接返回

    1. public function process(ServerRequestInterface $request, RequestHandlerInterface $handler): ResponseInterface
    2.     $auth = false;
    3.     // 如果验证不通过
    4.     if (!$auth) {
    5.         // response() 函数可以快速从 RequestContext 获得 Response 对象
    6.         return response()->withStatus(401);
    7.     }
    8.     // 委托给下一个中间件处理
    9.     $response = $handler->handle($request);
    10.     return $response;
    11. }

    抛出异常返回

    只要在请求生命周期内抛出的异常会被 ErrorHandler 捕获并处理，中间件内抛出也是如此，这部分不属于中间件的内容，顾在此不多做阐述。

    1. <?php
    3. namespace App\Middlewares;
    5. use Psr\Http\Server\RequestHandlerInterface;
    6. use Psr\Http\Message\ResponseInterface;
    7. use Psr\Http\Message\ServerRequestInterface;
    8. use Swoft\Bean\Annotation\Bean;
    9. use Swoft\Http\Message\Middleware\MiddlewareInterface;
    11. /**
    12.  * @Bean()
    13.  */
    15. {
    16.      * Process an incoming server request and return a response, optionally delegating
    17.      * response creation to a handler.
    18.      *
    19.      * @param \Psr\Http\Message\ServerRequestInterface $request
    20.      * @param \Psr\Http\Server\RequestHandlerInterface $handler
    21.      * @return \Psr\Http\Message\ResponseInterface
    22.      * @throws \InvalidArgumentException
    23.      */
    24.     public function process(ServerRequestInterface $request, RequestHandlerInterface $handler): ResponseInterface
    25.     {
    26.         if ('OPTIONS' === $request->getMethod()) {
    27.             return $this->configResponse(\response());
    28.         }
    30.         $response = $handler->handle($request);
    32.         return $this->configResponse($response);
    33.     }
    35.     private function configResponse(ResponseInterface $response)
    36.     {
    37.         return $response
    38.             ->withHeader('Access-Control-Allow-Origin', 'http://mysite')
    39.             ->withHeader('Access-Control-Allow-Headers', 'X-Requested-With, Content-Type, Accept, Origin, Authorization')
    40.             ->withHeader('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE, PATCH, OPTIONS');