基礎(chǔ) ―― HTTP 中間件
基礎(chǔ) —— HTTP 中間件
1、簡(jiǎn)介
HTTP。例如，Laravel包含了一個(gè)中間件來(lái)驗(yàn)證用戶是否經(jīng)過(guò)授權(quán)，如果用戶沒(méi)有經(jīng)過(guò)授權(quán)，中間件會(huì)將用戶重定向到登錄頁(yè)面，否則如果用戶經(jīng)過(guò)授權(quán)，中間件就會(huì)允許請(qǐng)求繼續(xù)往前進(jìn)入下一步操作。
當(dāng)然，除了認(rèn)證之外，中間件還可以被用來(lái)處理更多其它任務(wù)。比如：CORS中間件可以用于為離開站點(diǎn)的響應(yīng)添加合適的頭（跨域）；日志中間件可以記錄所有進(jìn)入站點(diǎn)的請(qǐng)求。
Laravel框架內(nèi)置了一些中間件，包括維護(hù)模式中間件、認(rèn)證、CSRF保護(hù)中間件等等。所有的中間件都位于app/Http/Middleware目錄。
2、定義中間件
想要?jiǎng)?chuàng)建一個(gè)新的中間件，可以通過(guò)Artisan命令make:middleware：
php artisan make:middleware OldMiddleware這個(gè)命令會(huì)在app/Http/Middleware目錄下創(chuàng)建一個(gè)新的中間件類OldMiddleware，在這個(gè)中間件中，我們只允許提供的age大于200的訪問(wèn)路由，否則，我們將用戶重定向到主頁(yè)：
<?php
namespace App\Http\Middleware;
use Closure;
class OldMiddleware
{
/**
* 返回請(qǐng)求過(guò)濾器
*
* @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，中間件會(huì)返回一個(gè)HTTP重定向到客戶端；否則，請(qǐng)求會(huì)被傳遞下去。將請(qǐng)求往下傳遞可以通過(guò)調(diào)用回調(diào)函數(shù)$next。
理解中間件的最好方式就是將中間件看做HTTP請(qǐng)求到達(dá)目標(biāo)之前必須經(jīng)過(guò)的“層”，每一層都會(huì)檢查請(qǐng)求甚至?xí)耆芙^它。
2.1 中間件之前/之后
一個(gè)中間件是否請(qǐng)求前還是請(qǐng)求后執(zhí)行取決于中間件本身。比如，以下中間件會(huì)在請(qǐng)求處理前執(zhí)行一些任務(wù)：
<?php
namespace App\Http\Middleware;
use Closure;
class BeforeMiddleware
{
public function handle($request, Closure $next)
{
// 執(zhí)行動(dòng)作
return $next($request);
}
}然而，下面這個(gè)中間件則會(huì)在請(qǐng)求處理后執(zhí)行其任務(wù)：
<?php
namespace App\Http\Middleware;
use Closure;
class AfterMiddleware
{
public function handle($request, Closure $next)
{
$response = $next($request);
// 執(zhí)行動(dòng)作
return $response;
}
}3、注冊(cè)中間件
3.1 全局中間件
如果你想要中間件在每一個(gè)HTTP請(qǐng)求期間被執(zhí)行，只需要將相應(yīng)的中間件類放到app/Http/Kernel.php的數(shù)組屬性$middleware中即可。
3.2 分配中間件到路由
如果你想要分配中間件到指定路由，首先應(yīng)該在app/Http/Kernel.php文件中分配給該中間件一個(gè)簡(jiǎn)寫的key，默認(rèn)情況下，該類的$routeMiddleware屬性包含了Laravel內(nèi)置的入口中間件，添加你自己的中間件只需要將其追加到后面并為其分配一個(gè)key：
// 在 App\Http\Kernel 里中
protected $routeMiddleware = [
'auth' => \App\Http\Middleware\Authenticate::class,
'auth.basic' => \Illuminate\Auth\Middleware\AuthenticateWithBasicAuth::class,
'guest' => \App\Http\Middleware\RedirectIfAuthenticated::class,];中間件在HTTP kernel中被定義后，可以在路由選項(xiàng)數(shù)組中使用$middleware鍵來(lái)指定中間件：
Route::get('admin/profile', ['middleware' => 'auth', function () {
//
}]);4、中間件參數(shù)
中間件還可以接收額外的自定義參數(shù)，比如，如果應(yīng)用需要在執(zhí)行動(dòng)作之前驗(yàn)證認(rèn)證用戶是否擁有指定的角色，可以創(chuàng)建一個(gè)RoleMiddleware來(lái)接收角色名作為額外參數(shù)。
額外的中間件參數(shù)會(huì)在$next參數(shù)之后傳入中間件：
<?php
namespace App\Http\Middleware;
use Closure;
class RoleMiddleware
{
/**
* 運(yùn)行請(qǐng)求過(guò)濾器
*
* @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í)通過(guò)：分隔中間件名和參數(shù)名來(lái)指定，多個(gè)中間件參數(shù)可以通過(guò)逗號(hào)分隔：
Route::put('post/{id}', ['middleware' => 'role:editor', function ($id) {
//
}]);5、可終止的中間件
有時(shí)候中間件可能需要在HTTP響應(yīng)發(fā)送到瀏覽器之后做一些工作。比如，Laravel內(nèi)置的“session”中間件會(huì)在響應(yīng)發(fā)送到瀏覽器之后將session數(shù)據(jù)寫到存儲(chǔ)器中，為了實(shí)現(xiàn)這個(gè)，定義一個(gè)可終止的中間件并添加terminate方法到這個(gè)中間件：
<?php
namespace Illuminate\Session\Middleware;
use Closure;
class StartSession
{
public function handle($request, Closure $next)
{
return $next($request);
}
public function terminate($request, $response)
{
// 存儲(chǔ)session數(shù)據(jù)...
}
}terminate方法將會(huì)接收請(qǐng)求和響應(yīng)作為參數(shù)。一旦你定義了一個(gè)可終止的中間件，應(yīng)該將其加入到HTTP kernel的全局中間件列表中。
當(dāng)調(diào)用中間件上的terminate方法時(shí)，Laravel將會(huì)從服務(wù)容器中取出該中間件的新的實(shí)例，如果你想要在調(diào)用handle和terminate方法時(shí)使用同一個(gè)中間件實(shí)例，則需要使用容器的singleton方法將該中間件注冊(cè)到容器中。
更多建議：