4. Die View und ihr Modell
Bisher haben die Actions ihre Antworten selbst erzeugt: Text, JSON und einige HTML-Tags, als Zeichenkette geschrieben. In einer MVC-Anwendung ist dies die Aufgabe einer View: einer Datei, die das HTML der Seite beschreibt, mit Platzhaltern für die Daten, die ihr die Action übergibt – das Modell der View.
[Symfony] verwendet die View-Engine [Twig], die vom selben Team entwickelt wurde. Eine [Twig]-View ist eine Datei, deren Name auf [.html.twig] endet (das Ausgabeformat, gefolgt von der Engine) und die im Ordner [templates] der Anwendung gespeichert ist. Es ist eine Textdatei – in diesem Fall HTML –, in der drei Arten von Tags auf dem Server interpretiert werden:
- [{{ expression }}]: der Wert eines Ausdrucks, der in die Seite eingefügt wird;
- [{% instruction %}]: eine Anweisung (Tag); eine Bedingung ([{% if %}]); eine Schleife ([{% for %}]), Template-Vererbung ([{% extends %}], [{% block %}]), Einbindung ([{% include %}]) ...;
- [{# comment #}]: ein Kommentar, der auf der erzeugten Seite nicht erscheint.
Alles andere wird unverändert übernommen. Die Ausdrücke sind nicht in [PHP] geschrieben, sondern in der Sprache von [Twig], die einfacher und sicherer ist: [model.title] bezeichnet die Eigenschaft [title] des Objekts [model] (oder seine Methode [getTitle()] oder den Schlüssel [title] eines Arrays: [Twig] sucht es selbst heraus); Filter transformieren einen Wert ([name|upper] wandelt einen Namen in Großbuchstaben um); Funktionen führen Berechnungen durch ([path('home')] erzeugt eine URL). [Twig] ähnelt damit [Jinja2] ([Flask]), von dem es sich inspirieren ließ, oder der Engine von [Django]; es unterscheidet sich von [Blade] ([Laravel]) und [Razor] ([ASP.NET Core]), die HTML mit Code der Host-Sprache mischen. Eine [Twig]-View kann nicht beliebigen [PHP]-Code ausführen: Sie kann nur die ihr übergebenen Daten anzeigen. Das ist beabsichtigt: Die Anwendungslogik bleibt in den Klassen. Eine View wird nicht bei jeder Anfrage interpretiert: Bei der ersten Verwendung kompiliert [Twig] sie in eine [PHP]-Klasse, die im Ordner [var/cache/dev/twig] abgelegt wird und die es wiederverwendet, solange die View unverändert bleibt. Wir werden sehen, wie diese Datei aussieht.
4.1. Beispiel 13: Eine erste View
4.1.1. Die Konfiguration: config/bundles.php und config/packages/twig.yaml
[Twig] wird über ein Bundle in [Symfony] integriert, TwigBundle, das der Bundle-Liste der Anwendung hinzugefügt werden muss (Beispiel 01):
und konfiguriert:
Der einzige Schlüssel gibt den Ordner der Views an: [templates], im Projektordner gelegen. Das ist auch der Standardwert. In einem Standardprojekt werden diese beiden Dateien von [Symfony Flex] angelegt, wenn Sie [Twig] installieren ([composer require twig], siehe Einleitung).
4.1.2. Das Modell der View: src/Model/PageModel.php
Das Modell der View ist eine einfache unveränderliche Klasse (siehe Beispiel 03): die drei Informationen, die die View anzeigen wird. Es besteht keine Pflicht, das Modell einer View als Klasse zu definieren: Man könnte der View auch drei einzelne Variablen übergeben. Eine Klasse dokumentiert jedoch, was die View erwartet, und ermöglicht es dem Editor, den Code der Action zu überprüfen. Diesen Ansatz verfolgt die Fallstudie, in der jede wichtige View ihre eigene Modellklasse hat.
4.1.3. Der Controller: src/Controller/ViewsController.php
- Zeilen 20–23: Die Action erstellt das Modell der View. Die Funktion [date], aus [PHP] übernommen, formatiert die aktuelle Uhrzeit: [H] formatiert die Stunden, [i] formatiert die Minuten und [s] formatiert die Sekunden;
- Zeile 24: Die Methode [render] von [AbstractController] weist [Twig] an, die Seite zu erzeugen. Der erste Parameter ist der Name der View: der Dateipfad, relativ zum Ordner [templates]. Der zweite Parameter ist ein assoziatives Array, dessen Schlüssel jeweils zu einer Variablen in der View wird – hier nur eine: [model]. [render] liefert ein Objekt [Response] zurück, dessen Body die erzeugte Seite ist (vom Typ [text/html]);
- Zeilen 31–35: eine weitere View mit einer weiteren Variablen ([name]). Der dritte Parameter von [render] ist eine zu befüllende Antwort: hier eine 404-Antwort für eine benutzerdefinierte Fehlerseite. [new Response(status: ...)] übergibt den Code über einen benannten Parameter, während die übrigen Parameter ihre Standardwerte behalten;
- Zeilen 36–40: dieselbe View wie bei der Action [index], aber mit einem anderen Modell. Das ist der Vorteil der Trennung von Actions und Views: Eine einzige View kann von mehreren Actions verwendet werden.
4.1.4. Die View: templates/views/index.html.twig
- Zeile 5: ein [Twig]-Kommentar;
- Zeile 6: [{{ model.title }}] fügt den Wert der Eigenschaft [title] der Variablen [model] ein. Der Punkt ist der Zugriffsoperator von [Twig], wo [PHP] [$model->title] schreibt.
Alles, was durch [{{ }}] eingefügt wird, wird maskiert: Die Zeichen [<], [>], [&], ["] und ['] werden durch ihre HTML-Entitäten ersetzt. Diese Rolle spielte in Beispiel 09 die Funktion [htmlspecialchars], doch geschieht dies nun automatisch: Eine View kann daher nicht versehentlich von einem Benutzer gelieferten HTML-Code in die Seite einfügen.
4.1.5. Die View: templates/views/unknown.html.twig
Eine View muss kein Objekt erhalten: Die Variable [name] ist eine Zeichenkette.
4.1.6. Ausführung


Die angezeigte Uhrzeit entspricht der in [PHP] konfigurierten Zeitzone (der Direktive [date.timezone] in der Datei [php.ini]), hier die koordinierte Weltzeit (UTC); die Fallstudie wird zeigen, wie man sie für die Anwendung festlegt. Die Rohantwort zeigt die Arbeit von [Twig]: Die Tags [{{ }}] wurden durch ihre Werte ersetzt, und der Kommentar wurde entfernt.
Die „home“-Fehlerseite, gefolgt von einem Namen, der HTML enthält ([<b>martin], URL-kodiert):
Das Tag [<b>] wurde maskiert, obwohl weder die Action noch die View sich darum kümmern mussten (auch das Apostroph wurde maskiert: [']). Hier schließlich die von [Twig] kompilierte View, wie sie sich im Ordner [var/cache/dev/twig] findet (unter einem generierten Namen wie [f1/f1e0ff0a8a0dc68657a0b1aa94f3ef4b.php]), auf das Wesentliche reduziert:
Die View ist zu einer Klasse mit dem Namen [PHP] geworden, deren Methode [doDisplay] die Seite Stück für Stück erzeugt ([yield]). Jedes [{{ model.title }}] ist zu einem Aufruf von [CoreExtension::getAttribute] geworden (der die Eigenschaft, Methode oder den Schlüssel [title] sucht), der an die Methode [escape] (Maskierung) übergeben wird. Eine [Twig]-View ist also schlicht eine sicherere und besser lesbare Art, eine [PHP]-Datei zu schreiben, die HTML erzeugt.
4.2. Beispiel 14: Die Sprache Twig
Dieses Beispiel vereint die wichtigsten Konstrukte von [Twig] in einer einzigen View.
4.2.1. Das Modell und die Action
Das Modell der View wird durch drei unveränderliche Klassen definiert, jede in einer eigenen Datei ([PHP] verlangt keine Klasse pro Datei, aber der Class Loader von [Composer] sucht die Klasse [App\Model\Product] in der Datei [src/Model/Product.php]):
Das Modell enthält Werte verschiedener Typen: Zeichenketten, [null], Boolesche Werte, Arrays von Objekten, leere Arrays und Objekte, die andere Objekte enthalten. Die Preise sind hier vom Typ [float], um die Berechnungen in der View zu vereinfachen (Beispiel 06 hat gezeigt, warum wir ganze Cent-Beträge bevorzugen).
Die Action erstellt das Modell mit benannten Parametern (siehe Beispiel 02): Jedem Wert geht der Name des Parameters voran, für den er bestimmt ist, was den Aufruf trotz der Parameteranzahl lesbar macht.
4.2.2. Die View: templates/basics/index.html.twig
- Zeilen 9–10: Die Anweisung [{% set %}] erzeugt eine Variable in der View. Der Gesamtpreis wird vom Filter [reduce] berechnet, der ein Array auf einen einzigen Wert reduziert (wie [array_reduce], Beispiel 06): Seine Funktion erhält den akkumulierten Wert und das aktuelle Element; [(sum, p) => sum + p.price] ist eine Pfeilfunktion von [Twig]. Der Filter [length] liefert die Anzahl der Elemente eines Arrays (oder der Zeichen einer Zeichenkette). Solche Berechnungen sollten der Darstellung vorbehalten bleiben: Die Berechnung gehört normalerweise in die Action;
- Zeile 15: Ein Wert [null] wird als leere Zeichenkette angezeigt. Der Filter [default] ersetzt einen leeren (oder fehlenden) Wert durch einen Standardwert;
- Zeilen 17–18: [{{ }}] maskiert HTML (2a); der Filter [raw], fügt den Wert dagegen unverändert ein, ohne ihn zu maskieren (2b). [raw] ist dem von der Anwendung selbst erzeugten HTML vorbehalten, niemals für Benutzereingaben;
- Zeilen 20–24: eine Bedingung: [{% if %}], [{% elseif %}], [{% else %}], [{% endif %}]. Jeder Block wird durch eine Anweisung [{% end... %}] geschlossen;
- Zeilen 28–34: eine Schleife [{% for ... in ... %}] ... [{% endfor %}]. Innerhalb der Schleife beschreibt die spezielle Variable [loop] den Zustand der Schleife: [loop.index0] (die Nummer des Durchlaufs, bei 0 beginnend), [loop.index] (bei 1 beginnend), [loop.first], [loop.last] (true beim ersten bzw. letzten Durchlauf), [loop.length] (die Anzahl der Elemente). Variablen außerhalb der Schleife ([model.name]) bleiben zugänglich;
- Zeile 30: der ternäre Operator [condition ? a : b] ([Twig] akzeptiert auch [condition ? a], was eine leere Zeichenkette liefert, wenn die Bedingung falsch ist);
- Zeile 38: Eine Schleife [for] kann einen Block [{% else %}]haben, der ausgeführt wird, wenn die Liste leer ist. Das ist einfacher als ein [{% if %}] , das die Länge der Liste prüfen würde;
- Zeilen 41–42: berechnete Ausdrücke ([total / count]) und die Variablen aus [set]. Der Filter [number_format] formatiert eine Zahl: zwei Nachkommastellen, einen Punkt als Dezimaltrennzeichen und ein Komma als Tausendertrennzeichen. In Beispiel 16 werden wir eine viel bessere Möglichkeit sehen, Zahlen und Beträge zu formatieren;
- Zeile 44: Der Punkt durchläuft Objekte ([model.address.city]), und der Filter [upper] wandelt eine Zeichenkette in Großbuchstaben um (wobei Zeichen mit Akzenten korrekt behandelt werden);
- Zeile 46: Die Anweisung [{% verbatim %}] kopiert ihren Inhalt, ohne ihn zu interpretieren: Das ist nützlich, wenn eine Seite geschweifte Klammern enthält, die für ein [JavaScript]-Framework bestimmt sind.
[Twig] hat etwa fünfzig Filter ([lower], [capitalize], [trim], [join], [split], [slice], [sort], [date], [json_encode], [escape]...), etwa fünfzehn Funktionen ([range], [min], [max], [random]...) und Tests ([is defined], [is empty], [is null], [is iterable], [is even]...); die Bundles von [Symfony] ergänzen einige ([path], [asset], [form_row], [is_granted]...), und die Anwendung kann eigene schreiben (Beispiel 16).
4.2.3. Ausführung

Die erzeugte Seite:
Die Kommentare und Anweisungen sind verschwunden, hinterlassen aber ihre Leerzeichen: [Twig] entfernt den Zeilenumbruch, der auf ein Tag folgt, nicht aber die Einrückung, die ihm vorausgeht. Das hat keine Auswirkung: Der Browser ignoriert diese Leerzeichen. (Ein Bindestrich innerhalb eines Tags – wie [{%- ... -%}] oder [{{- ... -}}] – würde die umgebenden Leerzeichen entfernen.) Eine in die Seite eingefügte Zahl vom Typ [float] wird mit einem Dezimalpunkt geschrieben ([12.5]); [number_format] verwendet die ihm übergebenen Trennzeichen.
4.3. Beispiel 15: Templates, Fragmente, statische Dateien
Die Seiten einer Website haben meist dieselbe Struktur: eine Kopfzeile, eine Navigationsleiste, eine Fußzeile und dieselben Stylesheets. Statt diese Struktur in jeder View zu wiederholen, wird sie einmal in einem Template (Layout) geschrieben, das die Seiten erweitern. Dieses Beispiel verwendet außerdem [Bootstrap], das am weitesten verbreitete CSS-Framework, für das Layout.
4.3.1. Statische Dateien
Eine HTML-Seite verweist auf weitere Dateien: Stylesheets, [JavaScript]-Skripte und Bilder. Diese Dateien, die der Server unverändert sendet, heißen statische Dateien. Bei [Symfony] liegen sie im Ordner [public], den der Webserver unverändert ausliefert (Beispiel 01): Die Datei [public/css/styles.css] ist unter der URL [/css/styles.css] verfügbar, ohne dass [Symfony] beteiligt ist.
Einige zusätzliche CSS-Regeln zusätzlich zu [Bootstrap]: ein hellgrauer Hintergrund, der Stil der Fußzeile und der Stil für einen Fehlerbereich, der in den folgenden Beispielen verwendet wird.
[Bootstrap] wird in den Beispielen 15 bis 28 verwendet. Statt in den Ordner [public] jedes Benutzers eine Kopie zu legen, teilen sich die Beispiele es: Es befindet sich im Ordner [examples/common/bootstrap]. Dieser Ordner wird nicht vom Webserver ausgeliefert: Ein Controller, den alle diese Beispiele gemeinsam nutzen, liefert seine Dateien aus. Das ist die Datei [examples/common/BootstrapController.php]:
- Zeile 7: Die Klasse liegt im Namespace [Common], den die Datei [examples/composer.json] dem Ordner [examples/common] zuordnet (siehe Einleitung): Der Class Loader von [Composer] findet sie daher unabhängig vom jeweiligen Beispiel;
- Zeilen 16–17: eine Route, deren Parameter [{file}] jedes Pfadende akzeptiert, einschließlich Schrägstrichen (Beispiel 02): Die URL [/bootstrap/css/bootstrap.min.css] verweist auf die Datei [css/bootstrap.min.css] im Ordner. Die Route heißt [bootstrap];
- Zeilen 20–27: Das Ausliefern von Dateien, die über eine URL bezeichnet werden, erfordert Vorsicht: Eine URL wie [/bootstrap/..%2F..%2F15-layout%2F.env] (in der [/] als [%2F] kodiert ist) darf keinen Zugriff auf eine Datei außerhalb des Ordners gewähren. Die Funktion [realpath] von [PHP] berechnet den absoluten Pfad einer Datei, wobei sie deren Bestandteile [.] und [..] entfernt, oder liefert [false] zurück, wenn die Datei nicht existiert. Wir prüfen, ob der resultierende Pfad mit dem Pfad des Ordners beginnt ([str_starts_with]) und ob er auf eine Datei verweist ([is_file]); andernfalls wird ein 404-Fehler zurückgegeben. [DIRECTORY_SEPARATOR] ist das Pfadtrennzeichen des Systems: [\] unter [Windows], [/] anderswo;
- Zeilen 29–32: Ein Objekt [BinaryFileResponse] ist eine Antwort, die den Inhalt einer Datei sendet. Der Inhaltstyp wird anhand der Dateierweiterung bestimmt (geliefert von [pathinfo]), sodass ein Stylesheet korrekt als [text/css] deklariert wird: Ein Browser lehnt ein Stylesheet ab, das als etwas anderes deklariert ist.
Jedes Beispiel, das [Bootstrap] verwendet, deklariert diesen Controller als Service in seiner Datei [config/services.yaml]:
- Zeile 11: der Service [Common\BootstrapController] ohne spezielle Konfiguration ([~] ist der Wert von [null] in [YAML]): Er erhält die Einstellungen aus [_defaults], und [autoconfigure] macht ihn zu einem Controller, dessen Route sich zu denen der Anwendung gesellt (Beispiel 02).
4.3.2. Das Template: templates/layout.html.twig
- Zeile 6: Das Tag [viewport] weist mobile Browser an, die Seite in der Breite des Bildschirms darzustellen, was [Bootstrap] erwartet;
- Zeile 8: Die Direktive [{% block %}] markiert einen benannten Slot, den Seiten, die das Template erweitern, durch die Definition eines Blocks mit demselben Namen füllen können. Der zwischen [{% block title %}] und [{% endblock %}] geschriebene Inhalt ist der Standard-Inhalt des Platzhalters, den eine Seite verwendet, die diesen Block nicht definiert. [site_name] ist eine globale Variable, die in allen Views vorhanden ist (siehe [config/packages/twig.yaml], unten);
- Zeilen 10–11: Die Funktion [path] erzeugt die URL einer benannten Route (Beispiel 04) anhand der Werte ihrer Parameter, die in einem assoziativen Array von [Twig] übergeben werden ([{file: '...'}], das Äquivalent zu [['file' => '...']] in [PHP]). Die Funktion [asset] erzeugt die URL zu einer Datei im Ordner [public]. Die URLs von Hand zu schreiben ([/css/styles.css]) würde ebenfalls funktionieren, aber [path] und [asset] funktionieren auch, wenn die Anwendung unter einem URL-Präfix installiert ist;
- Zeile 16: [{% include %}] fügt den Inhalt einer anderen View ein, hier die Navigationsleiste. Die eingebundene View hat Zugriff auf die Variablen der View, die sie einbindet;
- Zeile 19: der Bereich, den jede Seite mit ihrem eigenen Inhalt füllt;
- Zeile 23: Die Variable [app] ist in allen Views vorhanden: [Symfony] legt dort die aktuelle Anfrage ([app.request]), die Session ([app.session]), den angemeldeten Benutzer ([app.user], siehe den Abschnitt zur Sicherheit) und den Namen der Route ([app.current_route]) ab ... [app.request.pathInfo] ist der Pfad der angeforderten URL. Der Filter [date] formatiert ein Datum; die Zeichenkette ['now'] steht für die aktuelle Zeit.
Die Klasse [container] von [Bootstrap] zentriert den Inhalt und begrenzt seine Breite; [py-3] fügt einen vertikalen Innenabstand hinzu (padding): [Bootstrap] stellt Hunderte Klassen dieser Art bereit, die im Attribut [class] kombiniert werden. Die globale Variable [site_name] wird in der Konfiguration von [Twig] deklariert:
Variablen unter dem Schlüssel [globals] werden allen Views hinzugefügt, ohne dass die Actions sie bereitstellen müssen. Eine globale Variable kann auch ein Service sein (['@App\Service\...']), dessen Methoden von den Views aufgerufen werden.
4.3.3. Die Navigationsleiste: templates/fragments/navbar.html.twig
Ein Fragment: ein Teil einer Seite, der für sich genommen keine Bedeutung hat. Die Klassen [navbar], [navbar-brand] und [nav-link] sind die der Navigationsleiste von [Bootstrap]. Die Links werden von [path] anhand der Routennamen erzeugt.
4.3.4. Ein Makro: templates/macros.html.twig
- Zeile 4: Ein Makro ist ein Abschnitt einer Seite, der Parameter hat; das ist die Funktion von [Twig]. Es wird deklariert durch [{% macro name(parameters) %}] ... [{% endmacro %}]; ein Parameter kann einen Standardwert haben ([role = '']). Eine Datei kann mehrere Makros enthalten. Die Karte ([card]) ist eine Komponente von [Bootstrap].
Ein Makro kann nur auf seine eigenen Parameter (und auf globale Variablen) zugreifen; auf die Variablen der aufrufenden View hat es keinen Zugriff. Gerade das macht es wiederverwendbar. (Die Bibliothek [Symfony UX Twig Component] bietet funktionsreichere Komponenten – [PHP]-Klassen, die einer View zugeordnet sind –, die wie HTML-Tags verwendet werden: [<twig:Card name="..." />]; wir werden sie nicht benötigen.)
4.3.5. Die Seiten
- Zeile 2: Die Seite erweitert das Template: [Twig] erzeugt die Seite des Templates und ersetzt dessen Blöcke durch die von der Seite definierten. In einer View, die ein Template erweitert, muss sich der gesamte Inhalt innerhalb von Blöcken befinden: Außerhalb davon geschriebener Text erscheint nicht in der erzeugten Seite;
- Zeile 4: [{% import %}] importiert Makros aus einer Datei unter einem frei wählbaren Namen ([m]);
- Zeilen 6–12: der Block [content], der den gleichnamigen Slot füllt. Die Seite definiert den Block [title] nicht: Der Slot behält seinen Standardinhalt, „Home“;
- Zeile 11: der Aufruf des Makros [card] als Funktion: [m.card(...)], innerhalb von [{{ }}], da es einzufügenden Text erzeugt. Seine Ausgabe wird nicht ein zweites Mal maskiert: [Twig] weiß, dass sie bereits HTML-sicher ist (ihre Parameter wurden hingegen innerhalb des Makros maskiert).
- Zeile 4: der Block [title] in einer einzigen Zeile;
- Zeilen 8–15: eine Karte pro Teammitglied, in einem Raster von [Bootstrap] ([row], [col-md-4]: drei Spalten auf einem mittelgroßen oder großen Bildschirm, eine Spalte auf einem schmalen Bildschirm);
- Zeile 12: Die Parameter des Makros sind beliebige Ausdrücke.
Der Controller enthält nichts Neues:
Die dritte Seite schließlich verwendet das Template nicht:
4.3.6. Ausführung



Die Teamseite, wie sie der Browser empfängt:
Der Browser hat eine vollständige Seite erhalten: Template, Fragment, Seite und Makros wurden auf dem Server zusammengesetzt. Die URLs der Stylesheets wurden von [path] und [asset] erzeugt: Es sind auf die Website bezogene URLs. Sie können überprüfen, ob die Stylesheets korrekt ausgeliefert werden (die Option [-I] von [curl] zeigt nur die Antwort-Header an):
Die erste Datei wurde von unserem Controller gesendet ([BinaryFileResponse] fügt das Änderungsdatum der Datei hinzu und erlaubt das Caching: [Cache-Control: public]); die zweite wurde direkt vom Entwicklungsserver gesendet, ohne [Symfony] zu durchlaufen. Zum Schluss ein Versuch, den Ordner zu verlassen:
(Die Optionen [-s -o /dev/null -w "%{http_code}\n"] zeigen nur den Antwortcode an; geben Sie unter [Windows] [-o NUL] ein).
4.4. Beispiel 16: Twig-Erweiterungen
Eine View muss oft Werte formatieren: einen Betrag mit seiner Währung, ein ausgeschriebenes Datum oder Text in Großbuchstaben. Dieser Code gehört nicht in die Action (die sich nicht um die Darstellung kümmert), und [Twig] erlaubt es nicht, ihn in der View zu schreiben (die kein [PHP] ausführen kann; siehe die Einleitung dieses Kapitels). Er wird als [PHP] geschrieben, in einer Erweiterung von [Twig]: einer Klasse, die der Sprache der Views eigene Filter, Funktionen oder Tests hinzufügt. Bibliotheken stellen fertige bereit, etwa [twig/intl-extra], das mit den Beispielen installiert wird und Datumsangaben und Beträge sprachabhängig formatiert. Makros schließlich erzeugen HTML-Fragmente (Beispiel 15).
4.4.1. Die Erweiterung: src/Twig/FormatsExtension.php
- Zeile 14: Eine Erweiterung von [Twig] erbt von der Klasse [AbstractExtension]. Sie ist ein Service, wie jede Klasse im Ordner [src]; [Symfony] erkennt sie als Erweiterung ([autoconfigure]) und übergibt sie an [Twig];
- Zeilen 17–19: Die Erweiterung benötigt die Sprache der aktuellen Anfrage. Sie erhält den Request-Stack ([RequestStack]), einen Service von [Symfony] , der die aktuelle Anfrage kennt (es gibt einen Stack, weil eine Anfrage intern eine weitere auslösen kann);
- Zeilen 22–28: Die Methode [getFilters] liefert die Filter der Erweiterung: für jeden seinen Namen in den Views und die Funktion, die ihn implementiert. [$this->money(...)] (mit den drei Punkten) ruft die Methode nicht auf: Es macht daraus einen Wert – eine Funktion, die später aufgerufen werden kann (ein First-Class Callable). Eine Erweiterung kann auch Funktionen ([getFunctions]) und Tests ([getTests]) bereitstellen;
- Zeilen 33–37: Formatierung eines in Cent empfangenen Betrags (siehe Beispiel 06). Das hängt von der Sprache ab: Im Französischen [1 149,90 €] (Leerzeichen als Tausendertrennzeichen, Dezimalkomma, Symbol hinter dem Betrag); im Englischen [€1,149.90]. Die Klasse [NumberFormatter], Teil der Erweiterung [intl] von [PHP], unterstützt die Konventionen aller Länder (sie verwendet Daten des Unicode-Projekts CLDR): Sie wird für eine Sprache und einen Stil erzeugt (hier [CURRENCY] für Beträge), und [formatCurrency] formatiert einen Betrag, wobei die Währung durch ihren internationalen Code bezeichnet wird ([EUR], [USD]). Der erste Parameter des Filters ist der gefilterte Wert; die folgenden Parameter sind seine Eigenschaften in der View ([priceCents|money('USD')]);
- Zeilen 40–44: Formatierung eines Datums mit der Klasse [IntlDateFormatter] aus der Erweiterung [intl]: Der Stil [FULL] schreibt das Datum vollständig aus, einschließlich des Wochentags ([Sunday, September 27, 2026]); der Stil [NONE] für die Uhrzeit enthält sie nicht. Der Typ [DateTimeInterface] akzeptiert alle Datumsangaben von [PHP];
- Zeilen 46–49: die Sprache ([fr], [en]) der aktuellen Anfrage oder Englisch, wenn es keine Anfrage gibt (zum Beispiel in einem Konsolenbefehl). Wir werden sehen, wer sie festlegt.
4.4.2. Die Sprache jeder Anfrage: src/EventListener/SetLanguage.php
Jede Anfrage hat eine Sprache (Locale), die standardmäßig der in der Konfiguration angegebenen Sprache [default_locale] entspricht ([en] , wenn nichts konfiguriert ist). Hier wählt der URL-Parameter [?lang=fr] Französisch; Englisch ist die Standardsprache. Ein Listener für das Ereignis [kernel.request] (Beispiel 12) legt sie vor jeder Action mit der Methode [setLocale] der Anfrage fest. Der Parameter [priority] des Attributs legt die Reihenfolge der Listener desselben Ereignisses fest: Die mit der höchsten Priorität werden zuerst ausgeführt (Standard ist 0). [Symfony] selbst hat mehrere Listener für [kernel.request]: das Routing (Priorität 32), gefolgt von denen, die sprachabhängige Services vorbereiten (16 und 15). Unserer muss zwischen beiden laufen: 20. Der Befehl [php bin/console debug:event-dispatcher kernel.request] zeigt alle Listener des Ereignisses in der richtigen Reihenfolge an. Die so festgelegte Sprache gilt nur für die aktuelle Anfrage: Bei der nächsten gilt wieder die Standardsprache. Das Kapitel über die Internationalisierung wird dieselbe Sprache verwenden, um die Texte zu übersetzen.
4.4.3. Die Konfiguration: config/services.yaml
- Zeile 15: Die Filter der Bibliothek [twig/intl-extra] werden von der Erweiterung [IntlExtension] bereitgestellt. Ihre Klasse liegt nicht im Ordner [src]: Sie wird als Service deklariert, und [Symfony] erkennt sie als Erweiterung von [Twig] ([autoconfigure]). (In einem Standardprojekt erledigt das Paket [twig/extra-bundle], das von [Symfony Flex] installiert wird, dies selbst.)
4.4.4. Der Controller: src/Controller/PagesController.php
Die Actions übergeben den Views Rohwerte: ein Datum ([new DateTimeImmutable('today')], das heutige Datum um Mitternacht) und Beträge in Cent. Die Formatierung übernehmen die Views. Die Klasse [Product] vereint einen Namen, einen Preis (in Cent; siehe Beispiel 06) und einen Lagerbestand.
4.4.5. Die Views
- Zeilen 4–6: ein Makro, das einen Link für die Navigationsleiste erzeugt. Dem Link der aktuellen Seite wird die Klasse [active] von [Bootstrap] zugewiesen, die ihn hervorhebt. Ein Makro greift auf die globale Variable [app] zu (Beispiel 15): [app.request.pathInfo] ist der Pfad der aktuellen Anfrage; [starts with] ist ein Operator von [Twig], der den Anfang einer Zeichenkette prüft. Der ternäre Operator ohne „else“-Zweig ([condition ? ' active']) liefert eine leere Zeichenkette, wenn die Bedingung falsch ist (Beispiel 14);
- Zeilen 9–11: ein Badge von [Bootstrap], grün ([text-bg-success]) oder rot ([text-bg-danger]) je nach Lagerbestand. Der Operator [~] von [Twig] verkettet zwei Zeichenketten (der [.] von [PHP]).
- Zeile 1: Ein eingebundenes Fragment (Beispiel 15) erbt die Importe der View, die es einbindet, nicht: Es importiert die Makros, die es benötigt, selbst;
- Zeile 6: dasselbe wie beim Makro, direkt in der View geschrieben, mit dem ternären Operator. [app.current_route] ist der Name der Route der aktuellen Anfrage. Das Makro erspart es, die Bedingung für jeden Link zu wiederholen;
- Zeile 8: der Aufruf des Makros;
- Zeile 11: Ein Parameter von [path] , der kein Routenparameter ist, wird der URL als Parameter angehängt: [/products?lang=fr].
- Zeile 7: unser Filter [long_date];
- Zeile 9: [app.request.locale], die Sprache der Anfrage, festgelegt vom Listener [SetLanguage].
- Zeile 13: ein Filter von [Twig];
- Zeilen 14–15: unser Filter [money], zuerst mit seiner Standardwährung, dann mit einem Parameter;
- Zeile 17: der Aufruf des Makros [badge];
- Zeile 24: der Filter [format_currency] der Intl-Erweiterung: ein Betrag (hier in Euro: der Gesamtlagerbestand, berechnet durch [reduce], geteilt durch 100), eine Währung und die Sprache der Anfrage, übergeben über einen benannten Parameter von [Twig] ([locale: ...]). Diese Erweiterung stellt außerdem [format_date], [format_datetime], [format_number], [country_name], [language_name] ... bereit. Unser Filter [money] ist also doppelt vorhanden: Wir haben ihn geschrieben, um zu zeigen, wie man eine Erweiterung schreibt.
Das Template [layout.html.twig] ist eine vereinfachte Version des Templates aus Beispiel 15; sein Attribut [lang] erhält die Sprache der Anfrage ([<html lang="{{ app.request.locale }}">]).
4.4.6. Ausführung


Dieselbe Seite mit dem Parameter [?lang=fr]. Es ändert sich nur die Formatierung der Zahlen: Der Text selbst ist in den Views fest codiert. Das Kapitel über die Internationalisierung wird auch den Text übersetzen.

Ein Auszug aus dem erzeugten HTML:
4.5. Beispiel 17: Ein GET-Formular
Ein HTML-Formular sendet seine Felder je nach seinem Attribut [method] auf eine von zwei Arten an den Server:
- [method="get"]: Die Felder werden der URL als Parameter angehängt ([/search?keyword=le&genre=novel]). Diese Methode verwendet ein Formular, das eine Abfrage durchführt: eine Suche oder einen Filter. Die URL mit den Ergebnissen kann als Lesezeichen gespeichert, weitergegeben oder gefahrlos neu geladen werden;
- [method="post"]: Die Felder werden in den Body der Anfrage aufgenommen (siehe Beispiel 11). Diese Methode verwendet ein Formular, das Daten ändert: eine Registrierung, ein Hinzufügen oder ein Löschen.
Dieses erste Formular ist eine Buchsuche. Es ist in der View von Hand in HTML geschrieben; die folgenden Beispiele verwenden für die Formulare die Form-Komponente von [Symfony].
4.5.1. Das Modell: src/Model/Book.php und SearchModel.php
- Zeilen 14–19: Das Modell der View enthält die Eingaben des Benutzers, die das Formular anzeigt, die Liste der vorgeschlagenen Genres und die Ergebnisse.
4.5.2. Der Controller: src/Controller/BooksController.php
- Zeile 16: Eine private Klassenkonstante namens [self::GENRES] ([self] bezeichnet die aktuelle Klasse). Eine Konstante kann keine Objekte enthalten: Die Bücher werden daher von einer statischen Methode bereitgestellt (Zeilen 19–28). In einer realen Anwendung kämen sie aus einer Datenbank;
- Zeilen 32–33: zwei Routen für dieselbe Action: Das Attribut [#[Route]] kann wiederholt werden. Beim ersten Aufruf ([/]) gibt es keine Parameter, und alle Bücher werden angezeigt;
- Zeilen 37–38: Die Formularfelder werden als URL-Parameter gelesen (Beispiel 07). Die Methode [getString] liefert den Parameter als Zeichenkette zurück, leer, wenn er fehlt;
- Zeilen 40–43: Filterung. Die Funktion [array_filter] behält die Elemente eines Arrays, für die die angegebene Funktion [true] zurückliefert: Ein Buch wird ausgewählt, wenn das Schlüsselwort leer ist oder in seinem Titel oder Autor vorkommt (auf beiden Seiten in Kleinbuchstaben; [mb_strtolower] behandelt Zeichen mit Akzenten korrekt), und wenn das Genre leer ist oder dem Genre des Buchs entspricht. [array_filter] behält die Schlüssel der ausgewählten Elemente (0, 2 ...): [array_values] nummeriert sie ab 0 neu;
- Zeilen 44–46: das Modell der View.
4.5.3. Die View: templates/books/search.html.twig
- Zeile 6: das Tag [<form>]. Das Attribut [action] ist die URL, an die das Formular gesendet wird; [method="get"] legt die Felder in die URL. Die Klassen von [Bootstrap] ordnen die Felder in einer einzigen Zeile an;
- Zeile 8: ein Label. Sein Attribut [for] gibt den Bezeichner ([id]) des Felds an, das es beschreibt: Ein Klick auf das Label setzt den Cursor in das Feld, und Screenreader lesen das Label zusammen mit dem Feld vor;
- Zeile 10: ein Eingabefeld. Sein Attribut [name] ist der Name des Parameters , der an den Server gesendet wird: Das ist die Verbindung zwischen dem Formular und der Action ([$request->query->getString('keyword')]). Das Attribut [value] ist der angezeigte Wert: die vorherige Eingabe, erneut angezeigt (und maskiert durch [{{ }}], was in einem Attribut unerlässlich ist: Eine Eingabe mit einem Anführungszeichen ["] würde sonst das Attribut schließen);
- Zeilen 14–20: eine Dropdown-Liste. Jede [<option>] hat einen Wert ([value]), der an den Server gesendet wird, und einen Text, der angezeigt wird. Die erste Option mit einem leeren Wert bedeutet „alle Genres“;
- Zeile 18: Der in der vorherigen Anfrage ausgewählten Option wird das Attribut [selected] zugewiesen. Es ist ein boolesches Attribut: Seine bloße Anwesenheit genügt; es hat keinen Wert. Der ternäre Operator ohne „else“-Teil schreibt es, wenn die Bedingung wahr ist, und schreibt andernfalls nichts. [==] ist die Gleichheit in [Twig];
- Zeile 23: der Submit-Button;
- Zeile 26: die Anzahl der Ergebnisse.
4.5.4. Ausführung

Geben wir [le] ein und wählen den Typ [novel] aus:

Die URL der Ergebnisseite enthält die Formularfelder: [/search?keyword=le&genre=novel]. Die Antwort auf das Formular:
„Madame Bovary“ wird nicht ausgewählt: „le“ kommt weder im Titel noch im Namen des Autors vor.
4.6. Beispiel 18: Formularfelder
Dieses Beispiel stellt alle Feldtypen eines HTML-Formulars vor, diesmal per POST gesendet. Es zeigt, wie jeder Feldtyp mit seinem aktuellen Wert erneut angezeigt wird, wie der Browser die Werte der einzelnen Felder sendet und wie der Server prüft, ob ein empfangener Wert tatsächlich eine der verfügbaren Optionen ist. All das wie in Beispiel 17 von Hand zu schreiben, wäre aufwendig und repetitiv. [Symfony] delegiert diese Aufgabe an seine Form-Komponente: Ein Formular wird durch eine Klasse beschrieben, seinen Typ; [Symfony] erzeugt das HTML, liest die gesendeten Felder, konvertiert und validiert sie und zeigt das Formular mit den Eingaben des Benutzers und etwaigen Fehlern erneut an. Das ist das Gegenstück zu [WTForms] in [Python].
4.6.1. Der Listen-Service: src/Service/ListsService.php
Die Dropdown-Listen des Formulars (Anreden, Länder, Hobbys, Sprachen) werden von einem Service bereitgestellt, nach dem Vorbild von Beispiel 06: In einer realen Anwendung kämen sie aus einer Datenbank. Jede Liste ist ein assoziatives Array: Der Schlüssel ist der angezeigte Text und der Wert das, was an den Server gesendet wird (das ist die Reihenfolge, die die Form-Komponente erwartet).
4.6.2. Die Konfiguration
- Zeilen 5–7: die Sprache und der Translator (Beispiel 09): Die Fehlermeldungen der Form-Komponente werden wie die des Validators auf Englisch sein;
- Zeile 9: die Session des Benutzers, auf die wir in Beispiel 20 noch näher eingehen werden: Die Form-Komponente legt dort das Anti-CSRF-Token ab (siehe unten);
- Zeile 11: der Anti-CSRF-Schutz für Formulare.
- Zeile 5: das Theme der Formulare. [Symfony] rendert jedes Feld mithilfe von [Twig]-Blöcken; ein Theme liefert die für ein CSS-Framework passende Version. Das Theme [bootstrap_5_layout.html.twig], das in [Symfony] enthalten ist, verwendet die Klassen von [Bootstrap] 5 ([form-control], [form-label], [is-invalid] ...). Die Anwendung kann eigene Themes schreiben oder einzelne Blöcke eines bestehenden Themes überschreiben.
4.6.3. Formulartyp: src/Form/FieldsType.php
- Zeile 17: Ein Formulartyp erbt von der Klasse [AbstractType]. Er ist ein Service (im Ordner [src] gelegen): Er kann andere Services entgegennehmen, hier den Listen-Service (Zeile 20);
- Zeile 25: Die Methode [buildForm] beschreibt die Felder, indem sie sie ([add]) einem Form-Builder hinzufügt: für jedes Feld seinen Namen, seinen Typ und seine Optionen. Der Feldname ist auch der Name der Daten, die es anzeigt; sein Label ist standardmäßig sein als Text formatierter Name ([name] wird zu „Name“);
- Zeilen 30–35: Ein Feld [ChoiceType] ist eine Dropdown-Liste, die durch die Option [choices] definiert wird. Mit der Option [expanded] wird es zu einer Gruppe von Radiobuttons (einem Feld mit Einfachauswahl). Die Option [label_attr] weist dem Label der Gruppe eine Klasse zu: [radio-inline] legt im Theme nebeneinander angeordnete Buttons fest. Die Option [constraints] legt die Validierungs-Constraints des Felds fest (Beispiel 08): Eine Anrede ist erforderlich;
- Zeile 37: Ein Feld [TextType] ist ein Eingabefeld. Die Option [required] hat standardmäßig den Wert [true]: [Symfony] setzt dann das HTML-Attribut [required], das der Browser prüft (Beispiel 19). Es sendet keinerlei Information an den Server: Es ist eine Constraint ([NotBlank]), die ein Feld für den Server verpflichtend macht;
- Zeile 39: ein Passwort ([PasswordType]), das niemals an die Seite zurückgegeben wird: Sein Feld ist bei der Anzeige immer leer;
- Zeilen 41–46: ein Datum ([DateType]), angezeigt durch ein einziges Feld [<input type="date">] (Option [widget]). Ein solches Feld tauscht seinen Wert mit dem Server im Format [yyyy-mm-dd] aus, unabhängig vom Format, in dem der Browser es anzeigt; die Option [input] legt fest, dass die Daten eine Zeichenkette sind (und kein Objekt [DateTime], was der Standard ist);
- Zeilen 48–54: eine Dropdown-Liste mit Mehrfachauswahl ([multiple]): Kontrollkästchen;
- Zeile 56: eine nicht erweiterte Liste mit Einfachauswahl: eine Dropdown-Liste;
- Zeilen 58–64: eine nicht erweiterte Liste mit Mehrfachauswahl: eine Mehrfachauswahlliste, die über vier Zeilen angezeigt wird (das HTML-Attribut [size], festgelegt durch die Option [attr]);
- Zeile 65: ein Textfeld ([TextareaType]) über zwei Zeilen;
- Zeile 67: ein verstecktes Feld ([HiddenType]).
[Symfony] stellt etwa dreißig Feldtypen bereit: [EmailType], [IntegerType], [MoneyType], [UrlType], [CheckboxType], [FileType], [CountryType], [RepeatedType] (Beispiel 19), [CollectionType] (eine Liste von Unterformularen) ...
4.6.4. Der Controller: src/Controller/FormController.php
- Zeile 16: eine einzige Action für beide Methoden: GET zeigt das Formular an, POST verarbeitet es. Das ist die übliche Art, eine Formular-Action mit [Symfony] zu schreiben;
- Zeile 20: die Anfangswerte des Formulars: ein assoziatives Array mit einem Wert pro Feld (einem Array für ein Feld mit mehreren Werten);
- Zeile 22: [createForm] erzeugt das Formular – ein Objekt [Form] – anhand seines Typs und der Anfangsdaten;
- Zeile 25: [handleRequest] untersucht die Anfrage. Bei einem GET tut es nichts. Bei einem POST, der die Formularfelder enthält, kopiert es sie in das Formular: Jedes Feld konvertiert seinen Wert (das Datum, die Listen usw.) und prüft, ob eine Auswahl zu den angebotenen gehört; danach validiert das Formular die Constraints und das Anti-CSRF-Token;
- Zeile 27: [isSubmitted]: Wurde das Formular gesendet?;
- Zeilen 29–34: für dieses Beispiel die Liste dessen, was der Browser tatsächlich gesendet hat. Die Felder eines [Symfony]-Formulars sind nach dem Formular benannt: [fields[name]], [fields[hobbies][]]. [PHP] organisiert sie daher in einem Array namens [fields] (Beispiel 10), das anschließend durchlaufen wird. [(array) $value] wandelt einen einzelnen Wert in ein Array mit einem Element um (ein Array bleibt ein Array); [implode] verbindet die Elemente eines Arrays zu einer Zeichenkette, getrennt durch den ersten Parameter;
- Zeilen 35–42: Das Modell der View erhält, was der Server empfangen hat: das Validierungsergebnis ([isValid]), die Fehler ([getErrors(true)]: die aller Felder) und die Daten ([getData]) des Formulars, von jedem Feld konvertiert. Der Operator [+=] fügt diese Schlüssel dem Array [$model] hinzu;
- Zeile 44: Das Formular wird an die View übergeben, die es zusammen mit den Eingaben des Benutzers und etwaigen Fehlern anzeigt.
4.6.5. Die View: templates/form/form.html.twig
- Zeile 6: Die Funktion [form_start] schreibt das Tag [<form>]: standardmäßig die Methode POST und die URL der aktuellen Seite; der zweite Parameter fügt HTML-Attribute hinzu;
- Zeile 8: Die Funktion [form_row] schreibt ein vollständiges Feld: sein Label, sein Eingabefeld (mit seinem aktuellen Wert) und seine Fehler, unter Verwendung der Klassen des Themes. [form.title] bezeichnet das Feld [title] im Formular. Sie können die Teile auch getrennt schreiben: [form_label], [form_widget], [form_errors];
- Zeilen 9–19: die übrigen Felder, angeordnet durch die Raster-Klassen von [Bootstrap];
- Zeile 22: [form_end] schreibt die noch nicht geschriebenen Felder (hier das versteckte Feld [token] und das versteckte Feld [_token], das Anti-CSRF-Token) und schließt dann das Tag [</form>];
- Zeile 25: die Prüfung [is defined]: Die Variable [received] existiert erst nach einem Absenden;
- Zeilen 30–33: die Fehler. Jeder ist ein Objekt [FormError], bei dem [origin] das Feld ist, das den Fehler enthält;
- Zeilen 39–41: Eine Schleife [for] über ein assoziatives Array, die sowohl die Schlüssel als auch die Werte durchläuft. Der Test [is iterable] unterscheidet zwischen Arrays (zusammengefasst durch den Filter [join]) und einzelnen Werten.
Das gesamte Formular hätte in einer einzigen Zeile geschrieben werden können: [{{ form(form) }}]. Die Funktionen [form_start], [form_row], und [form_end] erlauben es, die Felder nach Belieben anzuordnen.
4.6.6. Ausführung

Die Standardwerte sind sichtbar: der Radiobutton „Mme“, das Land „France“ und die Sprache „French“. Das erzeugte HTML lautet wie folgt (Auszüge, über mehrere Zeilen dargestellt):
[Symfony] hat alles geschrieben: die Bezeichner ([fields_title_1]), die mit ihren Feldern verknüpften Labels, die auf [[]] endenden Namen bei Feldern mit mehreren Werten (Beispiel 10), die Attribute [checked] und [selected] der gemeinsamen Werte und die Klassen von [Bootstrap]. Das letzte versteckte Feld, [fields[_token]], enthält das Anti-CSRF-Token. Ein CSRF-Angriff (Cross-Site Request Forgery) besteht darin, dass eine bösartige Website den Browser ihres Opfers dazu bringt, ein Formular an unsere Anwendung zu senden. Der Browser fügt die Cookies unserer Anwendung in die Anfrage ein – und damit die Session des angemeldeten Benutzers –, sodass die Anfrage legitim erscheint. Die Gegenmaßnahme: Jedes Formular unserer Anwendung enthält ein zufälliges, an die Session des Benutzers gebundenes Token, das die bösartige Website nicht kennen kann. Die Form-Komponente fügt jedem Formular dieses Token hinzu, und [handleRequest] lehnt jedes Formular ab, dessen Token fehlt oder falsch ist: Kein Formular kann es weglassen. (Das Attribut [data-controller] wird von einem optionalen Skript für [Symfony] verwendet, das den Schutz verstärkt; hier hat es keine Wirkung.) Füllen wir das Formular aus und senden es ab:

Die Seite zeigt, was der Server empfangen hat: ein Parameter pro Feld, mit mehreren Werten für die Kontrollkästchen und die Dropdown-Liste; das Passwort wurde gesendet, wird aber in seinem Feld nicht erneut angezeigt. Das versteckte Feld [token] wurde unverändert zurückgesendet: So lassen sich Informationen hin und her senden, die der Benutzer nicht sieht (die Fallstudie nutzt dies für die Versionsnummer eines Datensatzes). Ein verstecktes Feld ist jedoch kein geschütztes Feld: Der Benutzer kann es mit den Entwicklerwerkzeugen seines Browsers ändern, und der Server muss es wie jedes andere Feld validieren. Das Anti-CSRF-Token ist ebenfalls unter den empfangenen Feldern enthalten; es gehört nicht zu den Formulardaten.
Senden wir nun mit [curl] ein Formular ohne Token und mit einem Land, das nicht als Option aufgeführt war:
Das Formular ist aus drei Gründen ungültig : Das Anti-CSRF-Token fehlt (der Fehler ist dem Formular selbst zugeordnet), es wurde keine Anrede gesendet, und das Land [xx] gehört nicht zu den verfügbaren Optionen. Diese letzte Prüfung führt das Feld [ChoiceType] selbst durch, ohne dass wir sie verlangt hätten: Ein böswilliger Benutzer könnte alles Beliebige senden, nicht nur das, was die Seite angeboten hat. Die Meldungen sind auf Englisch: Die der Form-Komponente werden von [Symfony] übersetzt, ebenso wie die des Validators (Beispiel 09). Die Antwort hat den Statuscode 422 (Unprocessable Content): [render] wählt ihn automatisch, wenn ihm ein gesendetes, ungültiges Formular übergeben wird. Beachten Sie den Unterschied zu anderen Frameworks: [Symfony] lehnt die Anfrage nicht vor der Action ab; das Formular erklärt sich für ungültig, und die Action entscheidet, wie es weitergeht.
Damit das Token akzeptiert wird, muss sich [curl] wie ein Browser verhalten: zuerst das Formular anfordern und dabei das Session-Cookie behalten (Option [-c], die empfangene Cookies in einer Datei speichert), dann das Cookie (Option [-b]) und das aus der Seite gelesene Token erneut senden. Die Option [--data-urlencode] kodiert den Wert des Tokens selbst:
(Das Token ist das der Seite, die vom ersten Befehl empfangen wurde.) Es bleiben nur die beiden Eingabefehler.
4.7. Beispiel 19: Formularvalidierung
Ein Registrierungsformular, in dem jedes Feld eigene Validierungsregeln hat. Tritt ein Fehler auf, wird das Formular mit den Eingaben des Benutzers und einer Meldung unter jedem fehlerhaften Feld erneut angezeigt. Dieses Beispiel verwendet den Standardansatz von [Symfony]: Die Formulardaten sind ein Objekt, dessen Klasse die Constraints enthält (Beispiel 08); das Formular befüllt das Objekt und validiert es anschließend.
Die Dateien [config/packages/framework.yaml] und [config/packages/twig.yaml] sind die aus Beispiel 18.
4.7.1. Die Daten und ihre Constraints: src/Model/Registration.php
- Zeile 8: eine gewöhnliche Klasse, deren Eigenschaften öffentlich und veränderbar sind; das Formular befüllt sie nacheinander. Alle sind mit [null] initialisiert; das Objekt ist bei der ersten Anzeige leer;
- Zeilen 10–12: Der Name ist erforderlich und darf 20 Zeichen nicht überschreiten. Jeder Constraint wird hier eine eigene Meldung auf Englisch zugewiesen (Beispiel 09): [message] für [NotBlank], [maxMessage] für die Überschreitung von [Length];
- Zeilen 15–17: Die Constraint [Email] prüft, ob eine Adresse gültig ist, und verlangt einen vollqualifizierten Domainnamen ([example.com], nicht [example]);
- Zeilen 19–21: Das Alter ist eine ganze Zahl zwischen 18 und 120 ([notInRangeMessage]: die Meldung für [Range] bei Vorgabe eines Minimums und eines Maximums). Das Formular hat die Eingabe in eine ganze Zahl konvertiert;
- Zeilen 23–25: Das Passwort muss mindestens 6 Zeichen lang sein.
4.7.2. Das Formular: src/Form/RegistrationType.php
- Zeile 23: Die Option [attr] fügt dem Eingabefeld HTML-Attribute hinzu: [maxlength] begrenzt die Eingabe im Browser;
- Zeile 24: Ein Feld [EmailType] erzeugt ein [<input type="email">], das der Browser validieren kann;
- Zeilen 27–31: Ein Feld [IntegerType] erzeugt ein [<input type="number">] und konvertiert die Eingabe in eine ganze Zahl. Eine Eingabe, die keine ganze Zahl ist, kann nicht konvertiert werden: Das ist ein Konvertierungsfehler (kein Validierungsfehler; siehe Beispiel 08), dessen Fehlermeldung von der Option [invalid_message] geliefert wird;
- Zeilen 34–39: Ein Feld [RepeatedType] besteht aus zwei Feldern (hier zwei [PasswordType]-Feldern), die denselben Wert enthalten müssen: das Passwort und seine Bestätigung. Jedes hat seine eigenen Optionen ([first_options], [second_options]); unterscheiden sich die beiden Eingaben, lautet der Fehler [invalid_message]. Die Daten haben nur einen Wert: das Passwort;
- Zeilen 43–46: Die Methode [configureOptions] legt die Optionen des Formulars selbst fest: [data_class] gibt an, dass seine Daten ein Objekt [Registration] sind. Jedes Feld liest und schreibt die gleichnamige Eigenschaft.
[Symfony] kann den Typ eines Felds auch anhand der Constraints und des Typs der Eigenschaft ableiten: [->add('age')], das keinen Typ hat, würde einen [IntegerType] erzeugen, mit den aus [Range] abgeleiteten Attributen [min] und [max]. Wir haben dies der Klarheit halber ausdrücklich ausgeschrieben.
4.7.3. Der Controller: src/Controller/RegistrationController.php
- Zeile 19: Der Parameter [?html5=true] aktiviert die Validierung durch den Browser (siehe unten). [#[MapQueryParameter]] konvertiert ihn in einen booleschen Wert (Beispiel 07);
- Zeilen 21–23: Das leere Objekt [Registration] wird an das Formular übergeben; [handleRequest] befüllt es mit den gesendeten Feldern;
- Zeilen 26–28: [isValid] ist wahr, wenn jedes Feld konvertiert werden konnte und wenn das Objekt [Registration] seine Constraints erfüllt. Die Willkommensseite erhält dann das ausgefüllte Objekt (das folgende Beispiel wird zeigen, dass es besser ist, nach einem erfolgreichen POST weiterzuleiten);
- Zeilen 31–32: Andernfalls wird das Formular angezeigt: leer bei der ersten Anzeige; nach einem ungültigen Absenden zeigt es die Eingaben und Fehler zusammen mit dem Code 422 (Beispiel 18).
Das ungültige Formular wird also von der POST-Action selbst erneut angezeigt, die Eingaben und Fehler behält: So geht [Symfony] vor. Andere Frameworks wie [Laravel] antworten stattdessen mit einer Weiterleitung auf die Formularseite und behalten Eingaben und Fehler für die nächste Anfrage in der Session.
4.7.4. Die Views
- Zeile 12: Das Attribut [novalidate] deaktiviert die Validierung durch den Browser: Das Formular wird unverändert gesendet, und nur der Server validiert es. Genau das wollen wir zuerst beobachten. Der ternäre Operator wählt zwischen zwei Arrays von Attributen;
- Zeile 14: [form_widget(form)], auf das gesamte Formular angewendet, schreibt alle seine Felder, jeweils mit Label, Eingabefeld und Fehlermeldungen: Das Theme [Bootstrap] hebt ein ungültiges Feld rot hervor (Klasse [is-invalid]) und zeigt seine Meldung darunter an (Klasse [invalid-feedback]). Dafür mussten wir keine Komponenten schreiben;
- Zeilen 19–25: der Block [page_bottom], definiert durch das Template (siehe unten). [form.vars] enthält die für die View berechneten Formulardaten: [submitted] (gesendet?), [valid] (gültig?), [value], [errors] ... Wurde das Formular gesendet und ist ungültig, erscheint eine allgemeine Meldung in einem Bereich, dessen Stil durch [public/css/styles.css] definiert ist (Beispiel 15). Das Attribut [role="alert"] kennzeichnet dies für Screenreader.
- Zeile 15: ein zweiter Block, [page_bottom], der standardmäßig leer ist: Ein Template kann beliebig viele Blöcke haben.
[registration] ist das Objekt [Registration], befüllt und validiert: Beim Namen wurden die Leerzeichen entfernt (siehe unten), und das Alter ist eine ganze Zahl.
4.7.5. Ausführung
Senden wir ein Formular voller Fehler: ein Name, der nur aus Leerzeichen besteht, eine Adresse ohne vollständige Domain, ein Alter von 12, ein zu kurzes Passwort und eine abweichende Bestätigung:

Die Eingaben wurden beibehalten (außer den Passwörtern), und jeder Fehler wird unter dem zugehörigen Feld angezeigt. Der nur aus Leerzeichen bestehende Name wird als fehlend gemeldet: Die Form-Komponente entfernt die Leerzeichen um jede Eingabe (Feldoption [trim], standardmäßig auf true gesetzt). Beim Passwort gibt es hingegen nur einen Fehler, und zwar bei der Bestätigung: Wenn die beiden Eingaben voneinander abweichen, liefert das Feld [RepeatedType] keinen Wert, und die Länge wird nicht geprüft. Die URL ist die des Formulars, und [/register] zeigt an, dass die Seite von der Action als Antwort auf POST angezeigt wurde. Mit [curl] können Sie, indem Sie wie in Beispiel 18 das Anti-CSRF-Token mitsenden, auch etwas senden, was ein Browser nicht senden würde – ein nicht numerisches Alter:
Wir sehen die erneut angezeigten Eingaben, zusammen mit den HTML5-Attributen ([required], [min], [max]), der Klasse [is-invalid], der Konvertierungsmeldung und den Attributen [aria-...], die das Feld für Screenreader mit seiner Meldung verknüpfen.
4.7.6. Validierung durch den Browser
Entfernen wir das Attribut [novalidate], indem wir dem Link „aktivieren“ folgen (Parameter [?html5=true]). Der Browser prüft dann die Attribute [required], [type="email"], [min], [maxlength] ... vor dem Absenden des Formulars und zeigt eigene Meldungen in einem Tooltip unter dem ersten fehlerhaften Feld an („Bitte füllen Sie dieses Feld aus“, „Der Wert muss größer oder gleich 18 sein“ usw.): Das Formular wird nicht gesendet, solange ein Fehler vorliegt. [Symfony] erzeugt diese Attribute automatisch: [required] für jedes Feld (Option [required], z. B. 18), [type="email"] und [type="number"] je nach Feldtyp; [maxlength], [min], [max] und [minlength] stammen aus unseren Optionen [attr]. Sie müssen mit den Constraints konsistent bleiben.
Diese Validierung ist für den Benutzer bequem: Sie erfolgt sofort, ohne Hin und Her mit dem Server. Sie ersetzt jedoch nicht die serverseitige Validierung: Ein Benutzer kann sie deaktivieren, und ein Programm wie [curl] ignoriert sie vollständig. Die Regel gilt uneingeschränkt: Der Server validiert immer; die Validierung im Browser ist lediglich ein zusätzlicher Komfort.
Endlich eine korrekte Eingabe. Der Name, der mit Leerzeichen auf beiden Seiten eingegeben wurde, wurde vom Formular bereinigt:

4.8. Beispiel 20: Das Post/Redirect/Get-Muster
Wenn eine POST-Aktion mit einer Seite antwortet, ist diese Seite das Ergebnis eines POST. Lädt der Benutzer die Seite neu (drückt [F5]), sendet der Browser die POST-Anfrage erneut, nachdem er eine Warnung angezeigt hat, die kaum jemand liest: Der Befehl wird zweimal gesendet, und die Nachricht wird zweimal veröffentlicht. Das Post/Redirect/Get-Muster (PRG) vermeidet dieses Problem: Eine erfolgreiche POST-Aktion liefert keine Seite zurück, sondern antwortet mit einer Weiterleitung (Beispiel 04) auf eine GET-Seite, die der Browser sofort abruft. Das Neuladen dieser Seite führt lediglich die GET-Aktion erneut aus.
Ein Problem bleibt: Die GET-Seite möchte eine Nachricht anzeigen („Die Aufgabe wurde hinzugefügt“), aber diese Nachricht kennt die POST-Aktion, und sie kann keine Variable an eine Anfrage übergeben, die noch nicht stattgefunden hat. Die Lösung: Die Flash-Nachricht, die von der POST-Aktion in der Session abgelegt wird, bleibt erhalten, bis sie gelesen und angezeigt wurde, und wird dann verworfen.
4.8.1. Konfiguration: config/packages/framework.yaml
- Zeilen 6–8: die Session des Benutzers (Kapitel über Gültigkeitsbereiche): browserspezifische Daten, die von einer Anfrage zur nächsten erhalten bleiben. Sie wird auf dem Server gespeichert; der Browser hält nur einen Bezeichner dafür in einem Cookie. [handler_id: null] überlässt das Speichern dieser Daten [PHP] selbst, das jede Session in einer Datei ablegt; [save_path] wählt den Ordner – [var/sessions/dev] –, damit wir sie untersuchen können. [%kernel.environment%] ist die Umgebung ([dev]);
- Zeile 10: die Sperren (die Lock-Komponente, weiter unten beschrieben), gespeichert im Ordner [var/lock].
4.8.2. Der Service: src/Service/TasksService.php
Die Aufgabenliste wird von allen Benutzern gemeinsam genutzt und muss von einer Anfrage zur nächsten erhalten bleiben. In [Java], [C#] oder [Python] würde sie in einem einzigen Service im Speicher gehalten. In [PHP] ist das unmöglich: Wie wir in den Beispielen 01 und 06 gesehen haben, überlebt nichts die Anfrage. Die Liste muss daher außerhalb von [PHP] gespeichert werden: in einer Datenbank, einer Datei ... oder im Anwendungs-Cache, den wir hier verwenden.
- Zeilen 16–20: Der Service erhält zwei Services von [Symfony]. Der erste ist der Anwendungs-Cache (der Service [cache.app] aus der Cache-Komponente), ein Speicher für Schlüssel-Wert-Paare, repräsentiert durch das standardisierte Interface [CacheItemPoolInterface] (der PSR-6-Standard). Standardmäßig speichert er seine Werte in Dateien im Ordner [var/cache/dev/pools]; in der Produktion wird ein dedizierter Server bevorzugt, etwa [Redis] (eine Konfigurationszeile). Der zweite ist die Lock-Factory der Lock-Komponente;
- Zeilen 23–28: [getItem] ruft das Cache-Element ab, das unter einem Schlüssel gespeichert ist; [isHit] prüft, ob es existiert, und [get] liefert seinen Wert. Es kann jeder beliebige Wert gespeichert werden (hier ein Array von Zeichenketten): [Symfony] serialisiert ihn – das heißt, es wandelt ihn in Text um – mit der Funktion [serialize] von [PHP];
- Zeilen 35–47: Der Entwicklungsserver kann wie ein Produktionsserver mehrere Anfragen gleichzeitig in mehreren Prozessen verarbeiten (die Umgebungsvariable [PHP_CLI_SERVER_WORKERS] legt die Anzahl der Prozesse von [php -S] fest). Zwei gleichzeitige Hinzufügungen könnten dieselbe Liste lesen, jeweils ihre eigene Aufgabe hinzufügen und die Liste zurückschreiben: Der zweite Schreibvorgang würde die erste Aufgabe überschreiben. Eine Sperre stellt sicher, dass immer nur eine Anfrage den Code ausführt, den sie schützt: [createLock('tasks')] erstellt eine benannte Sperre; [acquire(true)] wartet, bis sie verfügbar ist, und erwirbt sie dann; [release()] gibt sie frei. Hier ist die Sperre eine Datei im Ordner [var/lock], die vom Betriebssystem gesperrt wird (die Funktion [flock]); alternativ würden sich mehrere Server eine Sperre teilen, die in [Redis] oder in einer Datenbank gespeichert ist;
- Zeilen 38–47: Der Block [try] … [finally] stellt sicher, dass die Sperre in jedem Fall freigegeben wird, selbst wenn eine Exception den Code unterbricht, den sie schützt;
- Zeilen 42–43: Das Cache-Element erhält seinen neuen Wert ([set]), danach wird es gespeichert ([save]). Ohne angegebene Lebensdauer bleibt es unbegrenzt erhalten ([expiresAfter(3600)] würde es eine Stunde lang aufbewahren).
4.8.3. Der Controller: src/Controller/TasksController.php
- Zeilen 29–35: Die Eingabe wird manuell validiert, um das Beispiel knapp zu halten ([trim] entfernt die umgebenden Leerzeichen). Eine ungültige Eingabe wird erneut angezeigt (ohne Weiterleitung): Es gibt nichts, wovor man sich bei einer doppelten Übermittlung schützen müsste, da nichts verändert wurde;
- Zeile 39: Die Methode [addFlash] von [AbstractController] legt eine Flash-Nachricht vom Typ [success] in der Session ab (der Typ ist beliebig: Er erlaubt es, zwischen Erfolgs- und Fehlermeldungen usw. zu unterscheiden);
- Zeile 41: die Weiterleitung auf die GET-Seite mit dem Namen [tasks] (Beispiel 04);
- Zeilen 45–50: das Gegenbeispiel: eine Seite als Antwort auf POST. Der Operator [?:] liefert seinen linken Operanden, wenn dieser „wahr“ ist (hier ein nicht leerer String), andernfalls den rechten Operanden.
4.8.4. Die Views
- Zeilen 13–15: [app.flashes('success')] liefert die Liste der Flash-Nachrichten vom Typ [success] und entfernt sie aus der Session: Eine Flash-Nachricht wird nur einmal angezeigt. Die Klasse [alert alert-success] von [Bootstrap] zeigt die Nachricht in einem grünen Rahmen an;
- Zeilen 19–21: die Fehlermeldung am Ende der Seite, wenn die Aktion eine erzeugt hat.
- Zeile 11: der Operator [??] von [Twig] liefert seinen rechten Operanden, wenn der linke nicht existiert (oder gleich [null] ist): Die Variable [label] existiert nur nach einer ungültigen Eingabe;
- Zeile 14: Das [formaction]-Attribut eines Buttons sendet das Formular an eine andere Adresse als die in seinem [action]-Attribut angegebene: So kann ein einzelnes Formular zwei verschiedene Aktionen auslösen.
Diesem handcodierten Formular fehlt ein Anti-CSRF-Token: Um das Beispiel einfach zu halten, ergänzen wir es im nächsten Beispiel.
4.8.5. Wo werden Flash-Nachrichten gespeichert?
Zwischen der POST-Anfrage und der darauffolgenden GET-Anfrage muss die Nachricht irgendwo gespeichert werden: in der Session des Benutzers oder auf dem Server. Untersuchen wir das mit [curl] und speichern dabei die Cookies in einer Datei (Optionen [-c] und [-b], Beispiel 18):
Die Antwort auf POST ist eine Weiterleitung (Statuscode 302, Header [Location]) in Begleitung des Session-Cookies [PHPSESSID] (der Name, den [PHP] diesem Cookie gibt), das die Session-ID enthält: 32 zufällige Zeichen, die sich unmöglich erraten lassen. Dieses Cookie ist [httponly] (das [JavaScript] auf der Seite kann es nicht lesen) und [samesite=lax] (der Browser sendet es nicht mit einer POST-Anfrage, die von einer anderen Website stammt). Die Header [Cache-Control] und [Expires] verhindern das Caching einer Antwort, die von einer Session abhängt. Der Bezeichner ist zugleich der Name der Session-Datei auf dem Server: [var/sessions/dev/sess_1e1f574eccd93268b1eb829dd714a029]. Hier ist diese Datei nach der POST-Anfrage:
Das ist das Serialisierungsformat für Sessions in [PHP]: Jedes Stück Session-Daten wird in der Form [name|serialized value] geschrieben. [a:1:{...}] deklariert ein Array mit einem Element, [s:7:"success"] ein 7-Byte-String ... Sie enthält Flash-Nachrichten ([_symfony_flashes]), nach Typ sortiert, und Metadaten von [Symfony] ([_sf2_meta]: Erstellungsdatum der Session und Datum ihrer letzten Verwendung). Folgen wir der Weiterleitung und senden das Cookie zurück:
Die Nachricht wird von [app.flashes] angezeigt und aus der Session entfernt. Die nun leere Session ist sogar verschwunden: [Symfony] speichert keine leere Session, und die Datei wurde gelöscht. Eine neue GET-Anfrage würde die Nachricht nicht mehr anzeigen. Die Aufgabenliste hingegen wird in einer Cache-Datei gespeichert, deren Name aus dem Schlüssel berechnet wird ([var/cache/dev/pools/app/VT2eLxVxyZ/P/W/CElt3eODhIKkushDZW1A]):
Die erste Zeile ist das Ablaufdatum des Werts (0: nie), die zweite der Schlüssel und die dritte die serialisierte Liste. Die Sperre ist eine leere Datei, [var/lock/sf.tasks.CFFUCEx.lock], die das System für die Dauer einer Änderung sperrt.
4.8.6. Ausführung
Hinzufügen einer Aufgabe: Der Browser ist der Weiterleitung gefolgt; die URL ist die der GET-Seite, die gefahrlos neu geladen werden kann.

Eine ungültige Eingabe, erneut angezeigt mit ihrer Fehlermeldung:

Das Gegenbeispiel: Die Seite ist die Antwort auf POST, und ihre URL lautet [/tasks/without-prg]. Wenn Sie auf [F5] klicken, fragt der Browser, ob Sie das Formular erneut senden möchten; wenn Sie zustimmen, wird die Aufgabe ein zweites Mal hinzugefügt.

4.9. Beispiel 21: Links, Buttons und Bestätigung
Ein Prinzip des HTTP-Protokolls: Eine GET-Anfrage ändert nichts. Browser, Suchmaschinen und Tools, die Seiten vorab laden, folgen Links ohne Weiteres, ohne den Benutzer um Erlaubnis zu fragen. Ein „Löschen“-Link ([<a href="/contacts/2/delete">]) wäre daher gefährlich: Ein Bot, der die Website durchsucht, würde alles löschen. In einer Webanwendung gilt:
- Ansehen erfolgt über einen Link ([<a href>]), der eine GET-Anfrage sendet;
- Ändern (Speichern, Duplizieren, Löschen) erfolgt über einen Button in einem Formular, das durch ein Anti-CSRF-Token geschützt ist.
Dieses Beispiel verwaltet eine Kontaktliste und zeigt vor jedem Löschen ein Bestätigungsfenster an.
4.9.1. Konfiguration: config/packages/framework.yaml
- Zeile 6: Ein HTML-Formular kann nur GET- und POST-Anfragen senden. Das HTTP-Protokoll sieht jedoch weitere Methoden vor: DELETE zum Löschen sowie PUT und PATCH zum Ändern. [Symfony] umgeht diese Einschränkung: Mit der Option [http_method_override] wird ein POST-Formular mit einem versteckten Feld [_method] mit dem Wert [DELETE] (oder [PUT], [PATCH]) als Anfrage mit dieser Methode behandelt. Das ist Method Spoofing;
- die übrigen Zeilen stammen aus den Beispielen 18 und 20: die Session, der CSRF-Schutz und die Sperren.
4.9.2. Der Service: src/Service/ContactsService.php
Die Kontakte werden im Cache gespeichert, genau wie die Aufgaben in Beispiel 20. Jeder Kontakt ist ein unveränderliches Objekt [Contact] (eine ID, ein Name, eine Telefonnummer), gespeichert in einem Array zusammen mit der zuletzt vergebenen ID. Einige Anmerkungen zu [PHP]:
- Zeilen 37–49: Alle Änderungen folgen demselben Muster: Sperre erwerben, Daten lesen, ändern, zurückschreiben und die Sperre freigeben. Diese Methode schreibt einmal in das Array; jeder Änderung wird eine Funktion übergeben (vom Typ [callable], „aufrufbar“), die die Daten erhält und ändert. Die Funktion muss das Array selbst ändern, nicht eine Kopie: Ihr Parameter ist als [array &$data] deklariert, wobei [&] eine Übergabe per Referenz angibt (ohne [&] wird ein Array kopiert; siehe Beispiel 06). Das Schlüsselwort [use] in einer anonymen Funktion gibt ihr Zugriff auf Variablen der umgebenden Funktion (Zeile 65: [$id], [$name], [$phone]);
- Zeile 44: Die Aufrufe folgen aufeinander: [getItem] liefert das Element, [set] weist ihm einen Wert zu und gibt das Element selbst zurück, [save] speichert es;
- Zeilen 63–75: Ein Kontakt ist unveränderlich: Es wird ein neuer erstellt, der den alten im Array ersetzt. Eine Zuweisung ist ein Ausdruck, dessen Wert der zugewiesene Wert ist: [return $data['contacts'][$i] = new Contact(...)] ersetzt den Kontakt und gibt ihn zurück;
- Zeile 80: [++] vor einer Variablen erhöht diese um 1 und gibt den neuen Wert zurück;
- Zeile 92: [array_splice] entfernt ein Element aus dem Array und nummeriert die nachfolgenden Elemente neu;
- Die Methoden geben [null] für einen nicht existierenden Kontakt zurück: Der Controller entscheidet über die Antwort.
4.9.3. Das Formular für den Datensatz: src/Form/ContactType.php
- Zeilen 17–18: Die beiden Felder sind Pflichtfelder;
- Zeilen 20–21: zwei Submit-Buttons ([SubmitType]) sind Teil des Formulars. Beim Absenden des Formulars sendet der Browser den Namen des angeklickten Buttons, und das Formular weiß, welcher es ist. Die Option [attr] weist ihnen ihre Klassen aus [Bootstrap] zu.
4.9.4. Der Controller: src/Controller/ContactsController.php
- Zeile 16: das Namenspräfix [contacts]: Die Route für die Liste, deren Name leer ist (Zeile 30), heißt daher [contacts], und die für den Datensatz heißt [contacts_details] ...;
- Zeilen 24–27: eine Hilfsfunktion: Ein nicht existierender Kontakt beendet die Aktion mit einer 404-Antwort;
- Zeilen 30–34: die GET-Aktion für die Liste, die nichts verändert;
- Zeilen 37–58: der Datensatz eines Kontakts. Bei GET zeigt sie das Formular an, gefüllt mit den Informationen des Kontakts; bei POST verarbeitet sie es. Dieselbe URL, nämlich [/contacts/2], dient somit sowohl zum Ansehen als auch zum Speichern;
- Zeile 45: die Formulardaten, ein unstrukturiertes assoziatives Array: [['name' => $name, 'phone' => $phone] = ...] speichert jedes Element in einer Variablen;
- Zeilen 46–54: [get('duplicate')] liefert den Button [duplicate] des Formulars; [isClicked()] stellt fest, ob er derjenige war, der das Formular abgesendet hat (der Test [instanceof SubmitButton] bestätigt dem Editor den Objekttyp). Je nach Button dupliziert die Aktion den Kontakt oder speichert ihn;
- Zeile 55: in beiden Fällen das PRG-Schema (Beispiel 20) mit einer Flash-Nachricht;
- Zeilen 61–71: das Löschen, verarbeitet durch eine DELETE-Anfrage (dieselbe URL, aber mit einer anderen Methode). Das Löschformular ist fest in der View codiert: Die Aktion prüft ihr eigenes Anti-CSRF-Token mit der Methode [isCsrfTokenValid] von [AbstractController]. Ein Token ist an einen Bezeichner (hier [delete-contact-2]) gebunden: Das Token eines Formulars ist nur für dieses Formular gültig. Ein fehlendes oder ungültiges Token beendet die Aktion mit einem 403-Fehler (Forbidden). (Das Attribut [#[IsCsrfTokenValid('...')]], an der Aktion angebracht, würde dieselbe Prüfung durchführen.)
4.9.5. Die Views
- Zeile 13: ein Link, der durch die Klassen von [Bootstrap] ([btn] ...) als Button dargestellt wird: Das Erscheinungsbild hat nichts mit der HTTP-Methode zu tun. [path('contacts_details', {id: contact.id})] setzt die ID in den Pfad: [/contacts/2];
- Zeilen 15–22: ein Formular für jeden „Löschen“-Button, ohne andere Felder als die Methode und das Token. Die Klasse [d-inline] zeigt es in derselben Zeile wie den Link an. Das Attribut [data-confirmation] enthält die Bestätigungsnachricht: Die Attribute [data-...] sind nicht belegt und für das [JavaScript] auf der Seite gedacht;
- Zeile 18: das versteckte Feld [_method], das aus diesem POST eine DELETE-Anfrage macht;
- Zeile 20: das Anti-CSRF-Token, erzeugt von der Funktion [csrf_token] von [Twig] für den Bezeichner [delete-contact-2] (der Operator [~] verkettet, Beispiel 16).
- Zeilen 10–11: die beiden Formular-Buttons, dargestellt von [form_widget], nebeneinander;
- Zeile 12: der Link zurück zur Liste. [form_end] erzeugt das Anti-CSRF-Token, das die Form-Komponente selbst validiert (Beispiel 18).
4.9.6. Das Bestätigungsfenster
Der Browser kann einen Bestätigungsdialog anzeigen (Funktionen [JavaScript] und [confirm]), er ist jedoch wenig ansprechend, und sein Aussehen hängt vom Browser ab. Hier verwenden wir ein modales Fenster von [Bootstrap], das mit ein paar Zeilen [JavaScript] angezeigt wird. Das Fenster ist ein Fragment, das in das Template eingebunden ist und daher – wenn auch verborgen – auf allen Seiten vorhanden ist:
- Zeile 2: Die Klasse [d-none] von [Bootstrap] blendet das Element aus;
- Zeilen 3–4: der graue Hintergrund und danach das Fenster werden von den Klassen von [Bootstrap] dargestellt;
- Zeile 11: die Position der Nachricht;
- Zeilen 14–15: die beiden Buttons vom Typ [button] (nicht [submit]: Sie senden kein Formular ab), unterschieden durch ihr Attribut [data-action].
- Zeile 19: das Fenster, auf allen Seiten eingebunden;
- Zeile 21: das Skript, am Ende der Seite platziert: Wenn es ausgeführt wird, existieren die gesuchten Elemente bereits. Es liegt im Ordner [public/js].
Das Skript [public/js/app.js]:
- Zeile 3: Der Code ist in eine anonyme Funktion eingeschlossen, die sofort ausgeführt wird; ihre Variablen stören die der anderen Skripte auf der Seite nicht;
- Zeilen 4–6: das Fenster, die Stelle der Nachricht und das Formular, das auf Bestätigung wartet;
- Zeilen 9–17: Für jedes Formular mit einem [data-confirmation]-Attribut wird das Ereignis [submit] – ausgelöst beim Absenden des Formulars – abgefangen. [preventDefault()] unterbricht das Absenden; das Formular wird in die Warteschleife gestellt, und seine Nachricht ([dataset.confirmation], der Wert des Attributs [data-confirmation]) wird im Fenster angezeigt, das erscheint;
- Zeilen 20–28: ein einziger Handler für Klicks im Fenster: [event.target] ist das angeklickte Element; sein Attribut [data-action] gibt an, um welchen Button es sich handelt. „Ja“ sendet das wartende Formular mit der Methode [submit()] ab, die – anders als ein Klick auf einen Button – das Ereignis [submit] nicht auslöst (sonst würde das Fenster wieder erscheinen); „Nein“ blendet das Fenster aus.
Ohne [JavaScript] wird das Formular einfach ohne Bestätigung abgesendet: Die Seite bleibt benutzbar. Das ist inkrementelle Verbesserung: [JavaScript] fügt Komfort hinzu, aber die Anwendung hängt nicht davon ab.
4.9.7. Ausführung
Die Kontaktliste:

Ein Klick auf „Löschen“ zeigt das Bestätigungsfenster an:

Nach der Bestätigung die (simulierte) DELETE-Anfrage, die Weiterleitung und die Pop-up-Nachricht:

Das Profil eines Kontakts mit seinen beiden Sende-Buttons:

Eine Anfrage ohne Anti-CSRF-Token wird abgelehnt, und ein nicht existierender Kontakt liefert einen 404-Fehler:
Die Fehlerseiten sind weiterhin die detaillierten aus dem Debug-Modus von [Symfony]. Das Kapitel über den Lebenszyklus einer Anfrage zeigt, wie man sie durch eigene Seiten ersetzt.