Slim 框架的中間件：構(gòu)建強(qiáng)大的 PHP 微型應(yīng)用

Slim 是一個(gè)功能強(qiáng)大的 PHP 微型框架，其中間件功能允許在應(yīng)用中實(shí)現(xiàn)各種過濾器式服務(wù)，例如身份驗(yàn)證和緩存。中間件封裝應(yīng)用程序，並能影響應(yīng)用程序的環(huán)境以及請求和響應(yīng)對象。

關(guān)鍵要點(diǎn):

• Slim 的中間件是一個(gè)強(qiáng)大的特性，允許實(shí)現(xiàn)各種過濾器式服務(wù)，如身份驗(yàn)證和緩存。中間件封裝應(yīng)用程序，並能影響應(yīng)用的環(huán)境、請求和響應(yīng)對象。
• 在 Slim 中實(shí)現(xiàn)中間件，需要編寫一個(gè)擴(kuò)展 SlimMiddleware 類並重寫 call() 方法的類。此方法是中間件的入口點(diǎn)，可以從中返回（中斷執(zhí)行流程）或調(diào)用下一層。然後，中間件可以操作響應(yīng)的標(biāo)頭和正文。
• 使用 Slim 的 add() 方法註冊 Slim 應(yīng)用程序中的中間件?？梢酝ㄟ^後續(xù)調(diào)用 add() 方法註冊多個(gè)中間件。必須以與調(diào)用順序相反的順序添加中間件，因?yàn)樾碌闹虚g件會圍繞任何先前添加的中間件。中間件的配置通常通過服務(wù)的構(gòu)造函數(shù)完成。

Slim 中間件的理解

Slim 文檔將 Slim 應(yīng)用程序比作洋蔥，洋蔥的每一層都是中間件。這是一個(gè)恰當(dāng)?shù)谋扔鳌榱烁玫乩斫馑?，讓我們假設(shè)我們正在編寫一個(gè)使用身份驗(yàn)證和緩存的應(yīng)用程序。我們的架構(gòu)可能如下所示：

負(fù)責(zé)生成頁面內(nèi)容的代碼被包裝在幾層中間件中，最重要的是身份驗(yàn)證邏輯和緩存邏輯。執(zhí)行流程經(jīng)過每一層，要么允許流向下一層，要么被轉(zhuǎn)移。首先檢查用戶是否已通過身份驗(yàn)證。如果沒有，則中斷流程並返回 HTTP 401 狀態(tài)。然後檢查是否可以使用內(nèi)容的緩存副本。如果是，則使用緩存的頁面副本中斷流程?？赡艽嬖谄渌虚g件層，直到流程最終到達(dá)負(fù)責(zé)生成頁面的邏輯。當(dāng)我們的中間件方法返回時(shí)，執(zhí)行流程會通過它們冒泡返回。例如，緩存中間件的其餘邏輯將緩存頁面的內(nèi)容以供以後查找。

中間件的實(shí)現(xiàn)

要了解如何實(shí)現(xiàn)自定義中間件，讓我們看看可以作為上面提到的緩存中間件的代碼。實(shí)現(xiàn)任何基本 Slim 中間件組件的要求實(shí)際上非常少。我們只需要編寫一個(gè)擴(kuò)展 SlimMiddleware 類並重寫 call() 方法的類。中間件的入口點(diǎn)是此 call() 方法，我們可以從中返回（從而中斷執(zhí)行流程）或調(diào)用下一層。

<?php namespace MyMiddleware;

class Cache extends SlimMiddleware
{
    protected $db;

    public function __construct(PDO $db)
    {
        $this->db = $db;
    }

    public function call()
    {
        $key = $this->app->request()->getResourceUri();
        $rsp = $this->app->response();

        $data = $this->fetch($key);
        if ($data) {
            // 緩存命中...返回緩存的內(nèi)容
            $rsp["Content-Type"] = $data["content_type"];
            $rsp->body($data["body"]);
            return;
        }

        // 緩存未命中...繼續(xù)生成頁面
        $this->next->call();

        if ($rsp->status() == 200) {
            // 緩存結(jié)果以供將來查找
            $this->save($key, $rsp["Content-Type"], $rsp->body());
        }
    }

    protected function fetch($key)
    {
        $query = "SELECT content_type, body FROM cache
            WHERE key = " . $this->db->quote($key);
        $result = $this->db->query($query);
        $row = $result->fetch(PDO::FETCH_ASSOC);
        $result->closeCursor();
        return $row;
    }

    protected function save($key, $contentType, $body)
    {
        $query = sprintf("INSERT INTO cache (key, content_type, body)
            VALUES (%s, %s, %s)",
            $this->db->quote($key),
            $this->db->quote($contentType),
            $this->db->quote($body)
        );
        $this->db->query($query);
    }

}

call() 方法首先檢查內(nèi)容是否在緩存中可用。如果是，它設(shè)置響應(yīng)的 Content-Type 標(biāo)頭和正文，然後返回，從而短路管道。如果緩存未命中，則調(diào)用 $this->next->call() 來調(diào)用下一個(gè)中間件層。當(dāng)流程從其他中間件調(diào)用返回到這一點(diǎn)時(shí)，會快速檢查請求狀態(tài)，並將相關(guān)數(shù)據(jù)緩存以供將來查找。因?yàn)樵擃悢U(kuò)展了 Slim 的 Middleware 類，所以它可以通過 $this->app 訪問 Slim 應(yīng)用程序的實(shí)例，從而間接訪問響應(yīng)和請求對象。我們可以通過將其視為數(shù)組來影響響應(yīng)的標(biāo)頭，並通過其 body() 方法影響響應(yīng)的正文。 fetch() 和 save() 方法是受保護(hù)的輔助方法，它們只是包裝數(shù)據(jù)庫查詢以查找和持久化內(nèi)容。我在這裡包含它們只是為了完成示例。它假設(shè)存在一個(gè)名為 cache 的表，其中包含 key、content_type 和 body 列。根據(jù)您的需要，您的持久性機(jī)制可能有所不同。此外，此處未顯示（為簡單起見）緩存過期，儘管您可以自己輕鬆地合併它。

中間件的註冊和配置

使用 Slim 的 add() 方法註冊中間件。

<?php require_once "../vendor/autoload.php";

$app = new SlimSlim();
$app->add(new MyMiddlewareCache($db));

當(dāng)然，可以通過後續(xù)調(diào)用 add() 方法註冊多個(gè)中間件。因?yàn)樾碌闹虚g件會圍繞任何先前添加的中間件，這意味著必須以與調(diào)用順序相反的順序添加它們。

<?php $app = new SlimSlim();
$app->add(new MyMiddlewareCache($db));
$app->add(new MyMiddlewareAuth($db));
// ...

在上面的示例中，Cache 中間件包裝了 Slim 應(yīng)用，然後 Auth 中間件包裝了 Cache。當(dāng)調(diào)用 $app->run() 時(shí)，執(zhí)行流程將類似於上圖所示，首先進(jìn)入身份驗(yàn)證中間件，然後一直向下工作到路由。中間件的配置通常通過服務(wù)的構(gòu)造函數(shù)完成。在我們的示例中，我只是傳遞了一個(gè)活動的數(shù)據(jù)庫連接，以便它可以訪問緩存表，但是您可以編寫您的類以接受您可能需要自定義其行為的任何信息。例如，可以重寫該組件以接受一個(gè)公開fetch() 和save() 方法的處理程序?qū)ο?；這將允許我們刪除示例方法（或?qū)⑺鼈冇米髂J(rèn)回退），並且最終用戶開發(fā)人員將根據(jù)其需求提供功能作為組件配置的一部分。

結(jié)論

我發(fā)現(xiàn)中間件是實(shí)現(xiàn) Slim 應(yīng)用程序各個(gè)方面的優(yōu)雅解決方案。在本文中，我解釋了中間件架構(gòu)的工作原理以及實(shí)現(xiàn)自己的中間件所需的條件。有一個(gè)小型額外存儲庫，其中包含一些基本的中間件示例，例如 CSRF 保護(hù)和 HTTP 身份驗(yàn)證。我已經(jīng)重構(gòu)了這裡的示例並提交了一個(gè)拉取請求，因此，如果您編寫了一個(gè)有用的中間件服務(wù)，為什麼不考慮將其提交到項(xiàng)目中，以便其他人也能從中受益呢？

(圖片來自 Fotolia)

(以下為FAQ，已根據(jù)原文內(nèi)容調(diào)整和補(bǔ)充，並精簡部分重複內(nèi)容)

關(guān)於 Slim 中間件的常見問題

• 什麼是 Slim 中間件，為什麼它很重要？ Slim 中間件是 Slim 框架中一個(gè)強(qiáng)大的工具，允許您操作 HTTP 請求和響應(yīng)。它很重要，因?yàn)樗峁┝艘环N在 Slim 應(yīng)用程序之前和之後執(zhí)行代碼的方法，以修改傳入的請求或傳出的響應(yīng)。這可用於各種目的，例如身份驗(yàn)證、緩存或日誌記錄。

• 如何在 Slim 中創(chuàng)建中間件？ 在 Slim 中創(chuàng)建中間件涉及定義一個(gè)實(shí)現(xiàn) MiddlewareInterface 的類。此類應(yīng)該有一個(gè)名為 process() 的方法，該方法接收 ServerRequestInterface 和 RequestHandlerInterface。 process() 方法是您可以操作請求和響應(yīng)的地方。

• 如何將中間件添加到我的 Slim 應(yīng)用程序？ 可以使用 add() 方法將中間件添加到您的 Slim 應(yīng)用程序。此方法接收中間件類的實(shí)例。中間件按添加順序執(zhí)行，因此最後添加的中間件將是第一個(gè)執(zhí)行的中間件。

• 我可以將中間件用於 Slim 中的特定路由嗎？ 是的，中間件可以應(yīng)用於 Slim 中的特定路由。這是通過在 Route 對象而不是 App 對像上調(diào)用 add() 方法來完成的。這允許您擁有僅影響某些路由的中間件。

• 全局中間件和路由中間件有什麼區(qū)別？ 全局中間件應(yīng)用於 Slim 應(yīng)用程序處理的每個(gè)請求，而路由中間件僅應(yīng)用於特定路由。這允許您為應(yīng)用程序的不同部分使用不同的中間件。

• 如何使用中間件進(jìn)行 Slim 中的錯(cuò)誤處理？ 通過在中間件類中捕獲異常，可以使用中間件進(jìn)行 Slim 中的錯(cuò)誤處理。然後，您可以修改響應(yīng)以包含錯(cuò)誤信息，或?qū)⒂脩糁囟ㄏ虻藉e(cuò)誤頁面。

• 可以使用中間件在 Slim 中對用戶進(jìn)行身份驗(yàn)證嗎？ 是的，中間件通常用於 Slim 中的身份驗(yàn)證。這可以通過檢查中間件中的有效會話或令牌來完成，如果用戶未經(jīng)身份驗(yàn)證，則返回錯(cuò)誤響應(yīng)。

• 如何使用中間件在 Slim 中進(jìn)行日誌記錄？ 通過將有關(guān)請求和響應(yīng)的信息寫入日誌文件，可以使用中間件進(jìn)行日誌記錄。這對於調(diào)試或監(jiān)視您的應(yīng)用程序非常有用。

• 我可以將第三方中間件與 Slim 一起使用嗎？ 是的，Slim 支持第三方中間件。這可以像您自己的中間件一樣添加到您的應(yīng)用程序中。這允許您利用現(xiàn)有的中間件來完成常見任務(wù)。

• 如何測試我的 Slim 中間件？ 測試 Slim 中間件涉及創(chuàng)建模擬請求和響應(yīng)，並將它們傳遞給您的中間件。然後，您可以斷言中間件的行為符合預(yù)期，例如修改請求或響應(yīng)，或拋出異常。

以上是PHP主|使用Slim中間件的詳細(xì)內(nèi)容。更多資訊請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！