Laravel中間件原理

簡介

Laravel 中間件提供了一種方便的機制來過濾進入應用的 HTTP 請求, 如ValidatePostSize用來驗證POST請求體大小、ThrottleRequests用于限制請求頻率等。

那Laravel的中間件是怎樣工作的呢?

原文來自

啟動流程

再說Laravel中間件前,我們先來理一理laravel的啟動流程

首先,入口文件index.php加載了autoload和引導文件bootstrap

require __DIR__.'/../bootstrap/autoload.php';

$app = require_once __DIR__.'/../bootstrap/app.php';

并在引導文件bootstrap/app.php中初始化了Application實例

$app = new Illuminate\Foundation\Application(
    realpath(__DIR__.'/../')
);

我們先跳過如何初始化Application(后面會有簡單介紹),再回到入口文件(index.php)中,通過從Application實例$app中獲取Http Kernel對象來執行handle方法,換取response

$kernel = $app->make(Illuminate\Contracts\Http\Kernel::class);

$response = $kernel->handle(
    $request = Illuminate\Http\Request::capture()
);

$response->send();
$kernel->terminate($request, $response);

換取響應后,把響應內容返回給Client,并執行后續操作(terminate,如關閉session等)。

實例化Application

Laravel的容器并不是我這次說的重點,這里簡單介紹下

在初始化Application(啟動容器)時,Laravel主要做了三件事情

  1. 注冊基礎綁定
  2. 注冊基礎服務提供者
  3. 注冊容器核心別名

注冊完成以后,我們就能直接從容器中獲取需要的對象(如Illuminate\\Contracts\\Http\\Kernel),即使它是一個Interface

獲取Illuminate\Contracts\Http\Kernel類時,我們得到的真正實例是 App\Http\Kernel

// bootstrap/app.php

$app->singleton(
    Illuminate\Contracts\Http\Kernel::class,
    App\Http\Kernel::class
);

Laravel容器請參考

Handle

從容器中獲得Http Kernel對象后,Laravel通過執行kernel->handle來換取response對象。

//Illuminate\Foundation\Http\Kernel.php

public function handle($request)
{
    $request->enableHttpMethodParameterOverride();
    $response = $this->sendRequestThroughRouter($request);
    //......
}

enableHttpMethodParameterOverride方法開啟方法參數覆蓋,即可以在POST請求中添加_method參數來偽造HTTP方法(如post中添加_method=DELETE來構造HTTP DELETE請求)。

然后Laravel把請求對象(request)通過管道流操作。

protected function sendRequestThroughRouter($request)
{
    return (new Pipeline($this->app))
        ->send($request)
        ->through($this->app->shouldSkipMiddleware() ? [] : $this->middleware)
        ->then($this->dispatchToRouter());
}

/**
 * Get the route dispatcher callback.
 *
 * @return \Closure
 */
protected function dispatchToRouter()
{
    return function ($request) {
        $this->app->instance('request', $request);
        return $this->router->dispatch($request);
    };
}

Pipeline是laravel的管道操作類。在這個方法中,我的理解是:發送一個$request對象通過middleware中間件數組,最后在執行dispatchToRouter方法。注意,這里的中間件只是全局中間件。即首先讓Request通過全局中間件,然后在路由轉發中($this->dispatchToRouter()),再通過路由中間件中間件group

所以,到這里為止,Laravel的請求交給了Pipeline管理,讓我們來看看這個Pipeline究竟是怎樣處理的。

//Illuminate\Pipeline\Pipeline.php

public function then(Closure $destination)
{
    $pipeline = array_reduce(
        array_reverse($this->pipes), $this->carry(), $this->prepareDestination($destination)
    );
    return $pipeline($this->passable);
}

protected function prepareDestination(Closure $destination)
{
    return function ($passable) use ($destination) {
        return $destination($passable);
    };
}
 
protected function carry()
{
    return function ($stack, $pipe) {
        return function ($passable) use ($stack, $pipe) {
            if ($pipe instanceof Closure) {
                return $pipe($passable, $stack);
            } elseif (! is_object($pipe)) {
                list($name, $parameters) = $this->parsePipeString($pipe);
                $pipe = $this->getContainer()->make($name);
                $parameters = array_merge([$passable, $stack], $parameters);
            } else {
                $parameters = [$passable, $stack];
            }
            return $pipe->{$this->method}(...$parameters);
        };
    };
}

我們來看看最重要的then方法, 在這方法中$destination表示通過該管道最后要執行的Closure(即上述的dispatchToRouter方法)。passable表示被通過管道的對象Request

php內置方法array_reduce把所有要通過的中間件($this->pipes)都通過carry方法($this->pipes不為空時)并壓縮為一個Closure。最后在執行prepareDestination

array_reduce($pipes, callback($stack, $pipe), $destination), 當pipes為空時,直接執行destination,否則將所有$pipes壓縮為一個Closure,最后在執行destination

列如我有兩個中間件

Illuminate\Foundation\Http\Middleware\CheckForMaintenanceMode::class,
App\Http\Middleware\AllowOrigin::class,//自定義中間件

將這兩個中間件通過array_reduce方法時,返回壓縮后Closure如:

file

Closure共有三個層, 前面兩個為兩個中間件,后面個位最后要執行的Closure(即上述的dispatchToRouter方法)。

//中間件handle
public function handle($request, Closure $next)
{
}

在第一個通過的中間件(此處是CheckForMaintenanceModehandle方法中,dump($next)如下

file

在第二個通過的中間件(共兩個,此處是AllowOriginhandle方法中,dump($next)如下

file

由此可知,中間件在執行$next($request)時,表示該中間件已正常通過,并期待繼續執行下一個中間件。直到所有中間件都執行完畢,最后在執行最后的destination(即上述的dispatchToRouter方法)

以上是Laravel在通過全局中間件時的大致流程,通過中間件group和路由中間件也是一樣的, 都是采用管道流操作,詳情可翻閱源碼

Illuminate\Routing\Router->runRouteWithinStack


最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容

  • 什么是中間鍵 對于一個Web應用來說,在一個請求真正處理前,我們可能會對請求做各種各樣的判斷,然后才可以讓它繼續傳...
    伊Summer閱讀 1,701評論 0 3
  • 前言:laravel的中間件很方便,使用也很靈活,本文檔只是介紹簡單使用 生成中間件(默認在 /app/Http/...
    呦丶耍脾氣閱讀 3,573評論 0 0
  • 原文鏈接 必備品 文檔:Documentation API:API Reference 視頻:Laracasts ...
    layjoy閱讀 8,627評論 0 121
  • 先說幾句廢話,調和氣氛。事情的起由來自客戶需求頻繁變更,偉大的師傅決定橫刀立馬的改革使用新的框架(created ...
    wsdadan閱讀 3,097評論 0 12
  • Spring Cloud為開發人員提供了快速構建分布式系統中一些常見模式的工具(例如配置管理,服務發現,斷路器,智...
    卡卡羅2017閱讀 134,992評論 19 139