Middleware: Request-Regeln, Eingabe- und Ausgabe-Listener #

Diese Seite richtet sich an Entwickler, die übergreifende Request-Logik in Middleware (Laravel, Slim, Laminas, Express, Django), in Before- und After-Filter (Rails, CodeIgniter) oder in Kernel-Listener (Symfony) legen. Exponential hat keinen allgemeinen Middleware-Stack, dem Sie Klassen hinzufügen. Es hat drei Stellen, die zusammen die meisten Anwendungsfälle von Middleware abdecken.

Inhalt #

1. Die drei Stellen
2. Request-Regeln
3. Eingabe- und Ausgabe-Listener
4. Übliche Middleware, übertragen
5. Was keine Entsprechung hat

Die drei Stellen #

Die Reihenfolge innerhalb eines Requests steht unter Der Request-Lebenszyklus.

Request-Regeln #

Regeln sind Einstellungen: Bedingungen und eine Aktion, der Reihe nach geprüft; die erste Regel, deren Bedingungen alle zutreffen, entscheidet (Request-Regeln, vollständiger Leitfaden mit sechzehn Rezepten: Vollständige Sicherheit für Views).

# settings/siteaccess/<site>/requestrules.ini.append.php
<?php /*
[RequestRuleSettings]
RuleList[]=members_area

[Rule-members_area]
Description=Below node 864, anonymous visitors sign in first and come back.
Conditions[subtree]=864
Conditions[user]=anonymous
Action=login
*/ ?>

• 25 Bedingungen, darunter requested_via (System, Alias, Platzhalter, Startseite), uri, module_view, view_mode, node, subtree, class, section, state, user, role, policy, siteaccess, host, header, ip und fact.
• 8 Aktionen: allow, notfound, forbidden, login, redirect, redirect_to_alias, rewrite, log.
• Regeln nehmen nur Zugriff weg oder schicken den Besucher woandershin; sie gewähren nie einen Zugriff, den eine Richtlinie verweigert hat.
• Jede Antwort außer allow wird mit private, no-store gesendet.
• Prüfen Sie, was die Regeln entscheiden, ohne etwas zu ändern: php bin/php/ezrequestrules.php -s site --uri=content/view/full/2.

In PHP können Sie Bedingungen, Aktionen, Fakten (ezpRequestFactProvider) und ganze zur Laufzeit berechnete Regelsätze (ezpRequestRuleProvider) ergänzen, registriert in [RequestRuleSettings] (Die Regeln in PHP erweitern).

Eingabe- und Ausgabe-Listener #

ezformtoken ist das Vorbild eines Middleware-Paars in Exponential. Seine settings/site.ini.append.php registriert:

[Event]
Listeners[]=request/input@ezxFormToken::input
Listeners[]=response/output@ezxFormToken::output

ezxFormToken::input() prüft das Token jedes POST vor dem Routing; ezxFormToken::output() fügt das versteckte Token-Feld jedem Formular mit method="post" im endgültigen HTML hinzu. Ein Filter-Listener wie response/output muss den Wert zurückgeben, den er erhält, geändert oder nicht (Ereignisse und Listener).

Übliche Middleware, übertragen #

Was keine Entsprechung hat #

• Middleware-Listen pro Route (->middleware('auth') an einer Route): Verwenden Sie functions der View und Request-Regeln mit einer Bedingung module_view.
• Den gesamten Aufruf in eine Closure einhüllen ($next($request)): Listener laufen davor oder danach, nicht darum herum. Die Runnable-Ereignisse (runnable/view/before und after) kommen dem für eine einzelne View am nächsten.
• Reihenfolge der Middleware nach Priorität: Listener laufen in der Reihenfolge von Listeners[], Regeln in der Reihenfolge von RuleList[].

Verwandte Seiten #

• Härtung
• Sicherheit für Anwendungen
• Muster: Event-Hook
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.