Beherrschen Sie die Grundlagen der Laravel-Middleware

In diesem Artikel tauchen wir tief in das Laravel-Framework ein, um das Konzept der Middleware zu verstehen. Die erste Hälfte dieses Artikels beginnt mit einer Einführung in Middleware und ihre praktischen Anwendungen.

Im weiteren Verlauf werden wir uns mit der Erstellung benutzerdefinierter Middleware in einer Laravel-Anwendung befassen. Sobald wir unsere benutzerdefinierte Middleware erstellt haben, untersuchen wir die verfügbaren Optionen für die Registrierung bei Laravel, damit sie tatsächlich während des Anforderungsbearbeitungsablaufs aufgerufen werden kann.

Ich hoffe, Sie sind mit den grundlegenden Laravel-Konzepten und dem Artisan-Befehlszeilentool zum Generieren von Gerüstcode vertraut. Natürlich können Sie mit einer funktionierenden Installation der neuesten Laravel-Anwendung die in diesem Artikel bereitgestellten Beispiele sofort ausführen.

Was ist Middleware in Laravel?

Wir können uns Middleware als einen Mechanismus vorstellen, der es Ihnen ermöglicht, eine Verbindung zum typischen Anforderungsverarbeitungsablauf einer Laravel-Anwendung herzustellen. Die typische Verarbeitung der Laravel-Routen durchläuft bestimmte Phasen der Anforderungsverarbeitung, und Middleware ist eine der Schichten, die eine Anwendung durchlaufen muss.

Was bringt es also, den Anfragebearbeitungsprozess von Laravel einzubinden? Denken Sie über die Dinge nach, die in den frühen Phasen des Anwendungs-Bootstrappings erledigt werden müssen. Beispielsweise müssen Benutzer frühzeitig authentifiziert werden, um zu entscheiden, ob sie auf die aktuelle Route zugreifen dürfen.

Einige Dinge, die meiner Meinung nach mit Middleware erreicht werden können, sind:

• Aufzeichnungsanfrage
• Benutzer umleiten
• Eingehende Parameter ändern/bereinigen
• Manipulieren Sie die von Laravel-Anwendungen generierten Antworten
• Es gibt noch mehr

Tatsächlich enthält die Standardanwendung von Laravel bereits einige wichtige Middleware. Beispielsweise gibt es Middleware, die prüft, ob sich die Site im Wartungsmodus befindet. Andererseits gibt es Middlewares, um Eingabeanforderungsparameter zu bereinigen. Wie ich bereits erwähnt habe, wird die Benutzerauthentifizierung auch über die Middleware selbst implementiert.

Ich hoffe, die bisherigen Erklärungen haben Ihnen geholfen, sich im Umgang mit dem Begriff Middleware sicherer zu fühlen. Wenn Sie immer noch verwirrt sind, machen Sie sich keine Sorgen, denn im nächsten Abschnitt beginnen wir mit der Erstellung einer benutzerdefinierten Middleware, die Ihnen hilft, genau zu verstehen, wie Middleware in der realen Welt verwendet wird.

So erstellen Sie benutzerdefinierte Middleware

In diesem Abschnitt erstellen wir benutzerdefinierte Middleware. Aber was genau soll unsere benutzerdefinierte Middleware leisten?

Kürzlich bin ich auf die individuelle Anforderung eines Kunden gestoßen, dass ein Benutzer, wenn er von einem mobilen Gerät aus auf die Website zugreift, zur entsprechenden Subdomain-URL weitergeleitet werden soll, wobei alle Abfragezeichenfolgenparameter unverändert bleiben sollten. Ich glaube, dass dies ein perfekter Anwendungsfall ist, um zu demonstrieren, wie man Laravel-Middleware in diesem speziellen Szenario verwendet.

Der Grund, warum wir in diesem Fall Middleware verwenden möchten, besteht darin, dass wir uns in den Anforderungsfluss der Anwendung einbinden müssen. In unserer benutzerdefinierten Middleware überprüfen wir den Benutzeragenten und wenn sich der Benutzer auf einem mobilen Gerät befindet, wird er zur entsprechenden mobilen URL weitergeleitet.

Nachdem wir die gesamte Theorie besprochen haben, beginnen wir mit der eigentlichen Entwicklung. Das ist der beste Weg, ein neues Konzept zu verstehen, nicht wahr?

Wenn Sie als Laravel-Entwickler benutzerdefinierte Funktionen erstellen möchten, werden Sie die meiste Zeit das Artisan-Tool verwenden, um grundlegenden Vorlagencode zu erstellen. Lassen Sie uns damit einfachen Vorlagencode für unsere benutzerdefinierte Middleware erstellen.

Gehen Sie zur Befehlszeile und gehen Sie zum Dokumentstammverzeichnis Ihres Projekts. Führen Sie den folgenden Befehl aus, um eine benutzerdefinierte Middleware-Vorlage zu erstellen MobileRedirect.

php artisan make:middleware MobileRedirect

Dadurch sollte eine Datei mit dem folgenden Code erstellt werden app/Http/Middleware/MobileRedirect.php .

<?php
 
namespace App\Http\Middleware;
 
use Closure;
 
class MobileRedirect
{
    /**
     * Handle an incoming request.
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Closure  $next
     * @return mixed
     */
    public function handle($request, Closure $next)
    {
        return $next($request);
    }
}

Sie werden normalerweise die Implementierung der handle-Methode bemerken, die als Rückgrat der Middleware fungiert und in der sich die Hauptlogik der Middleware befinden sollte, die Sie implementieren möchten

Nutzen Sie diese Gelegenheit, um die Arten von Middleware vorzustellen, die mit Laravel geliefert werden. Es gibt zwei Haupttypen: Front-Middleware und Post-Middleware.

Wie der Name schon sagt, handelt es sich bei Vor-Middleware um Middleware, die ausgeführt wird, bevor die Anfrage tatsächlich verarbeitet und die Antwort erstellt wird. Post-Middleware hingegen wird ausgeführt, nachdem die Anfrage von der Anwendung verarbeitet wurde und die Antwort zu diesem Zeitpunkt bereits erstellt wurde.

In unserem Fall müssen wir den Benutzer umleiten, bevor wir die Anfrage bearbeiten, sodass sie als Pre-Middleware entwickelt wird.

Machen Sie weiter und ändern Sie die Datei mit dem folgenden Inhalt app/Http/Middleware/MobileRedirect.php .

<?php
 
namespace App\Http\Middleware;
 
use Closure;
 
class MobileRedirect
{
    /**
     * Handle an incoming request.
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Closure  $next
     * @return mixed
     */
    public function handle($request, Closure $next)
    {
        // check if the request is from mobile device
        if ($request->mobile == "1") {
            return redirect('mobile-site-url-goes-here');
        }
 
        return $next($request);
    }
}

Der Einfachheit halber überprüfen wir nur mobile 查询字符串参数是否存在，如果将其设置为 TRUE, dann wird der Benutzer zur entsprechenden Site-URL für mobile Geräte weitergeleitet. Wenn Sie eine Echtzeiterkennung wünschen, sollten Sie natürlich eine Benutzeragenten-Erkennungsbibliothek verwenden.

Außerdem sollten Sie die mobile-site-url-goes-here-Route durch die richtige Route oder URL ersetzen, da es sich lediglich um einen Platzhalter für Demonstrationszwecke handelt.

按照我们的自定义逻辑，调用 $next($request) 允许在应用程序链中进一步处理请求。在我们的例子中需要注意的重要一点是，我们将移动检测逻辑放置在 $next($request) 调用之前，有效地使其成为一个 before 中间件。

这样，我们的自定义中间件就几乎准备好进行测试了。目前，Laravel 无法了解我们的中间件。为此，您需要向 Laravel 应用程序注册您的中间件，这正是我们下一节的主题。

在进入下一部分之前，我想演示一下后中间件的外观，以防万一有人对此感到好奇。

<?php
 
namespace App\Http\Middleware;
 
use Closure;
 
class CustomMiddleWare
{
    /**
     * Handle an incoming request.
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Closure  $next
     * @return mixed
     */
    public function handle($request, Closure $next)
    {
        $response = $next($request);
        
        /* your custom logic goes here */
        
        return $response;
    }
}

正如您已经注意到的，中间件的自定义逻辑在 Laravel 应用程序处理请求后执行。此时，您还可以访问 $response 对象，如果您愿意，它允许您操作它的某些方面。

这就是 after 中间件的故事。

我们的自定义中间件正在运行

本节描述了向 Laravel 应用程序注册中间件的过程，以便在请求处理流程中实际调用它。

继续打开文件 app/Http/Kernel.php 并查找以下代码片段。

/**
 * The application's global HTTP middleware stack.
 *
 * These middleware are run during every request to your application.
 *
 * @var array
 */
protected $middleware = [
    \Illuminate\Foundation\Http\Middleware\CheckForMaintenanceMode::class,
    \Illuminate\Foundation\Http\Middleware\ValidatePostSize::class,
    \App\Http\Middleware\TrimStrings::class,
    \Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull::class,
];

如您所见，$middleware 保存了 Laravel 默认安装附带的中间件数组。此处列出的中间件将根据每个 Laravel 请求执行，因此它是放置我们自己的自定义中间件的理想选择。

继续添加我们的自定义中间件，如以下代码片段所示。

protected $middleware = [
    \Illuminate\Foundation\Http\Middleware\CheckForMaintenanceMode::class,
    \Illuminate\Foundation\Http\Middleware\ValidatePostSize::class,
    \App\Http\Middleware\TrimStrings::class,
    \Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull::class,
    \App\Http\Middleware\MobileRedirect::class,
];

现在，尝试使用查询字符串 mobile=1 访问任何 Laravel 路由，这应该会触发我们的中间件代码！

这就是您应该注册需要在每个请求上运行的中间件的方式。但是，有时您希望仅针对特定路由运行中间件。让我们检查一下如何使用 $routeMiddleware 来实现这一点。

在我们当前示例的上下文中，我们假设如果用户访问您网站上的任何特定路由，他们将被重定向到移动网站。在这种情况下，您不想将中间件包含在 $middleware 列表中。

相反，您希望将中间件直接附加到路由定义，如下所示。

Route::get('/hello-world', 'HelloWorldController@index')->middleware(\App\Http\Middleware\MobileRedirect::class);

事实上，我们可以更进一步，为我们的中间件创建一个别名，这样您就不必使用内联类名。

打开文件 app/Http/Kernel.php 并查找 $routeMiddleware ，它保存了别名到中间件的映射。让我们将我们的条目包含到该列表中，如以下代码片段所示。

protected $routeMiddleware = [
    'auth' => \Illuminate\Auth\Middleware\Authenticate::class,
    'auth.basic' => \Illuminate\Auth\Middleware\AuthenticateWithBasicAuth::class,
    'bindings' => \Illuminate\Routing\Middleware\SubstituteBindings::class,
    'can' => \Illuminate\Auth\Middleware\Authorize::class,
    'guest' => \App\Http\Middleware\RedirectIfAuthenticated::class,
    'throttle' => \Illuminate\Routing\Middleware\ThrottleRequests::class,
    'mobile.redirect' => \App\Http\Middleware\MobileRedirect::class
];

修改后的路由定义如下所示。

Route::get('/hello-world', 'HelloWorldController@index')->middleware('mobile.redirect');

这就是向 Laravel 应用程序注册中间件的故事。这非常简单，不是吗？

事实上，我们已经读到了本文的结尾，我希望您能充分享受它。

结论

探索任何框架中的架构概念总是令人兴奋的事情，这就是我们在本文中探索 Laravel 框架中的中间件时所做的事情。

从中间件的基本介绍开始，我们将注意力转移到在 Laravel 应用程序中创建自定义中间件的主题。文章的后半部分讨论了如何向 Laravel 注册自定义中间件，这也是探索附加中间件的不同方式的机会。

希望这次旅程富有成效，并且本文能够帮助您丰富您的知识。另外，如果您希望我在即将发表的文章中提出特定主题，您可以随时给我留言。

今天就这样，如果有任何疑问，请随时使用下面的提要来提出您的疑问！

Das obige ist der detaillierte Inhalt vonBeherrschen Sie die Grundlagen der Laravel-Middleware. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!