Lumen HTTP 中間件

1、簡介

HTTP中間件提供了一個便利的機制來過濾進入應(yīng)用的HTTP請求。例如，Lumen包含了一個中間件來驗證用戶是否經(jīng)過授權(quán)，如果用戶沒有經(jīng)過授權(quán)，中間件會將用戶重定向到登錄頁面，否則如果用戶經(jīng)過授權(quán)，中間件就會允許請求繼續(xù)往前進入下一步操作。

當然，除了認證之外，中間件還可以被用來處理更多其它任務(wù)。比如：CORS中間件可以用于為離開站點的響應(yīng)添加合適的頭（跨域）；日志中間件可以記錄所有進入站點的請求。

2、定義中間件

中間件通常都放在app/Http/Middleware目錄下。想要創(chuàng)建一個新的中間件，需要在新創(chuàng)建的中間件中重寫handle方法。在下面中間件中，我們只允許提供的age大于200的訪問路由，否則，我們將用戶重定向到主頁：

<?php

namespace App\Http\Middleware;

use Closure;

class OldMiddleware
{
    /**
     * 返回請求過濾器
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Closure  $next
     * @return mixed
     */
    public function handle($request, Closure $next)
    {
        if ($request->input('age') <= 200) {
            return redirect('home');
        }

        return $next($request);
    }

}

正如你所看到的，如果age<=200，中間件會返回一個HTTP重定向到客戶端；否則，請求會被傳遞下去。將請求往下傳遞可以通過調(diào)用回調(diào)函數(shù)$next。

理解中間件的最好方式就是將中間件看做HTTP請求到達目標之前必須經(jīng)過的“層”，每一層都會檢查請求甚至?xí)耆芙^它。

2.1 中間件之前/之后

一個中間件是否請求前還是請求后執(zhí)行取決于中間件本身。比如，以下中間件會在請求處理前執(zhí)行一些任務(wù)：

<?php

namespace App\Http\Middleware;

use Closure;

class BeforeMiddleware
{
    public function handle($request, Closure $next)
    {
        // 執(zhí)行動作

        return $next($request);
    }
}

然而，下面這個中間件則會在請求處理后執(zhí)行其任務(wù)：

<?php

namespace App\Http\Middleware;

use Closure;

class AfterMiddleware
{
    public function handle($request, Closure $next)
    {
        $response = $next($request);

        // 執(zhí)行動作

        return $response;
    }
}

3、注冊中間件

3.1 全局中間件

如果你想要中間件在每一個HTTP請求期間被執(zhí)行，只需要將相應(yīng)中間件類放到bootstrap/app.php文件的$app->middleware()調(diào)用中即可。

3.2 分配中間件到路由

如果你想要分配中間件到指定路由，首先應(yīng)該在bootstrap/app.php文件中分配給該中間件一個簡寫的key，默認情況下，$app->routeMiddleware()方法包含了Lumen自帶的入口中間件，添加你自己的中間件只需要將其追加到后面并為其分配一個key：

$app->routeMiddleware([
    'old' => 'App\Http\Middleware\OldMiddleware',]);

中間件在入口文件中被定義好了之后，可以在路由選項數(shù)組中使用middleware鍵來指定中間件：

$app->get('admin/profile', ['middleware' => 'auth', function () {
    //
}]);

4、中間件參數(shù)

中間件還可以接收額外的自定義參數(shù)，比如，如果應(yīng)用需要在執(zhí)行動作之前驗證認證用戶是否擁有指定的角色，可以創(chuàng)建一個RoleMiddleware來接收角色名作為額外參數(shù)。

額外的中間件參數(shù)會在$next參數(shù)之后傳入中間件：

<?php

namespace App\Http\Middleware;

use Closure;

class RoleMiddleware
{
    /**
     * 運行請求過濾器
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Closure  $next
     * @param  string  $role
     * @return mixed
     * translator http://laravelacademy.org
     */
    public function handle($request, Closure $next, $role)
    {
        if (! $request->user()->hasRole($role)) {
            // Redirect...
        }

        return $next($request);
    }

}

中間件參數(shù)可以在定義路由時通過：分隔中間件名和參數(shù)名來指定，多個中間件參數(shù)可以通過逗號分隔：

$app->put('post/{id}', ['middleware' => 'role:editor', function ($id) {
    //
}]);

5、中止中間件

有時候中間件可能需要在HTTP響應(yīng)發(fā)送到瀏覽器之后做一些工作。比如，Lumen自帶的“session”中間件會在響應(yīng)發(fā)送到瀏覽器之后將session數(shù)據(jù)寫到存儲器中，為了實現(xiàn)這個，定義一個“終結(jié)者”中間件并添加terminate方法到這個中間件：

<?php

namespace Illuminate\Session\Middleware;

use Closure;

class StartSession
{
    public function handle($request, Closure $next)
    {
        return $next($request);
    }

    public function terminate($request, $response)
    {
        // 存儲session數(shù)據(jù)...
    }
}

terminate方法將會接收請求和響應(yīng)作為參數(shù)。一旦你定義了一個終結(jié)中間件，應(yīng)該將其加入到入口文件的全局中間件列表中。