Middleware in Lithe: Wie sie funktioniert und wie Sie Ihre eigene erstellen

Middlewares bieten einen praktischen Mechanismus zum Überprüfen und Filtern von HTTP-Anfragen, die in Ihrer Anwendung eingehen. Lithe enthält beispielsweise Middleware, die prüft, ob Ihr Anwendungsbenutzer authentifiziert ist. Wenn der Benutzer nicht authentifiziert ist, leitet die Middleware den Benutzer zum Anmeldebildschirm Ihrer Anwendung weiter. Wenn der Benutzer jedoch authentifiziert ist, lässt die Middleware zu, dass die Anfrage innerhalb der Anwendung fortgesetzt wird.

---

Wie Middleware in Lithe funktioniert

In Lithe sind Middleware Funktionen, die Zugriff auf das Anforderungsobjekt ($req), das Antwortobjekt ($res) und die $next-Funktion in der Anforderungs-Antwort-Schleife der Anwendung haben. Die $next-Funktion ist eine Funktion im Lithe-Router, die bei Aufruf die Middleware neben der aktuellen Middleware ausführt.

Middleware-Funktionen bieten einen praktischen Mechanismus zum Überprüfen, Filtern und Bearbeiten von HTTP-Anfragen, die in Ihre Anwendung eingehen.

Middleware-Funktionen können die folgenden Aufgaben ausführen:

• Führen Sie einen beliebigen Code aus.
• Änderungen an Anforderungs- und Antwortobjekten vornehmen.
• Beenden Sie den Anfrage-Antwort-Zyklus.
• Nächste Middleware im Stapel aufrufen.

Wenn die aktuelle Middleware-Funktion den Anfrage-Antwort-Zyklus nicht beendet, muss sie $next() aufrufen, um die Steuerung an die nächste Middleware-Funktion zu übergeben. Andernfalls bleibt die Anfrage ausstehend.

---

Elemente einer Middleware-Funktion

Der folgende Code zeigt die Elemente eines Middleware-Funktionsaufrufs:

$app->use(function ($req, $res, $next) {
    $next();
});

Wo:
- $req: HTTP-Anfrageargument für die Middleware-Funktion, laut Konvention „$req“ genannt.
- $res: HTTP-Antwortargument für die Middleware-Funktion, laut Konvention „$res“ genannt.
- $next: Callback-Argument für die Middleware-Funktion, laut Konvention „$next“ genannt.

---

Middleware definieren

Beginnen wir mit einem einfachen Middleware-Beispiel namens myLogger. Diese Middleware druckt die LOGGED-Nachricht jedes Mal aus, wenn eine Anfrage sie durchläuft. Middleware ist als eine Funktion definiert, die einer Variablen namens myLogger:
zugewiesen ist

$myLogger = function ($req, $res, $next) {
  echo 'LOGGED';
  $next();
};

Beachten Sie den Aufruf von $next() oben. Durch den Aufruf dieser Funktion wird die nächste Middleware-Funktion in der Anwendung aufgerufen. Die Funktion $next() ist kein Teil von PHP oder Lithe, aber sie ist das dritte Argument, das an die Middleware-Funktion übergeben wird. Die Funktion $next() könnte einen beliebigen Namen haben, heißt aber konventionsgemäß immer „next“. Um Verwirrung zu vermeiden, verwenden Sie immer diese Konvention.

Stellen Sie sich Middleware am besten als eine Reihe von „Schichten“ vor, die HTTP-Anfragen durchlaufen müssen, bevor sie Ihre Anwendung erreichen. Jede Ebene kann die Anfrage prüfen und sie sogar vollständig ablehnen.

---

Laden der Middleware

Um eine Middleware-Funktion zu laden, können Sie die use()-Methode der LitheApp-Klasse aufrufen und dabei die gewünschte Middleware-Funktion angeben. Der folgende Code lädt beispielsweise die Middleware-Funktion myLogger, bevor die Route zum Stammpfad (/) ausgeführt wird:

$app->use(function ($req, $res, $next) {
    $next();
});

Immer wenn die Anwendung eine Anfrage erhält, gibt sie die Meldung „LOGGED“ aus.

Die Ladereihenfolge der Middleware ist wichtig: Middleware-Funktionen, die zuerst geladen werden, werden auch zuerst ausgeführt.

Die myLogger-Middleware-Funktion druckt einfach eine Nachricht und übergibt die Anforderung dann an die nächste Middleware-Funktion auf dem Stapel, indem sie die Funktion $next() aufruft.

---

Verwendung von Middleware

Eine Lithe-Anwendung kann die folgenden Arten von Middleware verwenden:

• Middleware auf Anwendungsebene
• Middleware auf Router-Niveau
• Middleware von Drittanbietern

Middleware auf Anwendungsebene

Binden Sie Middleware auf Anwendungsebene mithilfe der Methoden use() und METHOD() an eine Instanz des Anwendungsobjekts, wobei METHOD die HTTP-Methode der Anforderung ist, die die Middleware-Funktion verarbeitet (z. B. GET, PUT oder POST). in Kleinbuchstaben.

Dieses Beispiel zeigt eine Middleware-Funktion ohne Assembly-Pfad. Die Funktion wird jedes Mal ausgeführt, wenn die Anwendung eine Anfrage erhält.

$myLogger = function ($req, $res, $next) {
  echo 'LOGGED';
  $next();
};

Das folgende Beispiel zeigt eine Middleware, die GET-Anfragen im Pfad /user/:id verarbeitet.

$app = new \Lithe\App;

$myLogger = function ($req, $res, $next) {
    echo 'LOGGED';
    $next();
};

$app->use($myLogger);

$app->get('/', function ($req, $res, $next) {
    $res->send('Hello World!');
});

Middleware auf Router-Ebene

Middleware auf Router-Ebene funktioniert genauso wie Middleware auf Anwendungsebene, außer dass sie an eine Instanz von LitheHttpRouter gebunden ist.

$app->use(function ($req, $res, $next) {
    echo 'Hello World!';
    $next();
});

Laden Sie Middleware auf Router-Ebene mit den Funktionen USE und METHOD.

Der folgende Beispielcode zeigt ein Middleware-System, das Middleware auf Router-Ebene verwendet:

$app->get('/user/:id', function ($req, $res, $next) {
    // Se o ID do usuário for '0', passa para o próximo middleware
    if ($req->param('id') === '0') {
        return $next();
    } 

    // Caso contrário, envia uma resposta específica
    $res->send('ID não é 0');
}, function ($req, $res) {
    // Envia uma resposta quando o ID for '0'
    $res->send('regular');
});

Middleware von Drittanbietern

Verwenden Sie Middleware von Drittanbietern, um Lithe-Apps Funktionalität hinzuzufügen.

Installieren Sie das für die gewünschte Funktionalität erforderliche PHP-Modul und laden Sie es dann auf Anwendungsebene oder auf Routerebene in Ihre Anwendung.

Das folgende Beispiel veranschaulicht das Laden der Sitzungs-Middleware, der LitheMiddlewareSessionsession-Funktion.

$router = new \Lithe\Http\Router;

Eine unvollständige Liste der Middleware-Funktionen von Drittanbietern, die häufig mit Lithe verwendet werden, finden Sie unter: Middleware von Drittanbietern.

Konfigurierbare Middleware

Wenn Ihre Middleware konfigurierbar sein soll, erstellen Sie eine Funktion, die ein Array von Optionen oder anderen Parametern akzeptiert und dann die Middleware-Implementierung basierend auf den Eingabeparametern zurückgibt.

$app->use(function ($req, $res, $next) {
    $next();
});

Jetzt kann die Middleware wie unten gezeigt verwendet werden.

$myLogger = function ($req, $res, $next) {
  echo 'LOGGED';
  $next();
};

Das obige ist der detaillierte Inhalt vonMiddleware in Lithe: Wie sie funktioniert und wie Sie Ihre eigene erstellen. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!