5. Internationalisierung
Eine internationalisierte Anwendung zeigt ihre Texte in der Sprache des Benutzers an. Die Fallstudie ist auf Französisch und Englisch verfügbar. Das Prinzip ist einfach: Die Views enthalten keinen Text mehr, sondern Schlüssel ([MENU.HOME]), und ein Wörterbuch pro Sprache ordnet jedem Schlüssel einen Text zu. Die gewählte Sprache wird in einem Cookie gespeichert.
[Symfony] enthält eine Übersetzungskomponente, den Translator, dem wir bereits in Beispiel 09 bei den Validierungsmeldungen begegnet sind. Seine Wörterbücher liegen im Ordner [translations], mit einer Datei pro Domäne und Sprache: [validators.en.yaml] (die Domäne der Validierungsmeldungen, Beispiel 09), [messages.en.yaml] (die Standarddomäne, die für unsere Texte). Das YAML-Format erlaubt verschachtelte Schlüssel: So sind die Wörterbücher der Versionen [ASP.NET Core MVC], [NestJS], [Spring MVC], [Flask] und [Laravel] der Fallstudie aufgebaut, abgesehen von der Syntax. Für die Syntax der Meldungen selbst wählen wir das ICU-Format (International Components for Unicode), einen Standard, den die Erweiterung [intl] von [PHP] interpretieren kann und der beispielsweise Text in die Pluralform flektieren kann. Die Formatierung von Daten und Beträgen bleibt dieselbe wie in Beispiel 16.
5.1. Beispiel 22: Eine zweisprachige Anwendung
5.1.1. Die Konfiguration: config/packages/framework.yaml
- Zeile 5: die Standardsprache der Anwendung, die für Anfragen verwendet wird, die keine Sprache angeben (Beispiel 09);
- Zeile 6: die von der Anwendung unterstützten Sprachen. Diese Liste wird von [Symfony] verwendet (Profiler, Generierung lokalisierter Routen usw.); unser eigener Code hat außerdem seine eigene Liste, im Listener [SetLanguage];
- Zeilen 9–11: der Übersetzungsservice. [fallbacks] legt die Fallback-Sprache(n) fest: Fehlt ein Schlüssel im Wörterbuch der angeforderten Sprache, wird er im englischen Wörterbuch gesucht. Ein Schlüssel, der in allen Wörterbüchern fehlt, wird unverändert angezeigt: So ist jedes Versäumnis sofort auf dem Bildschirm sichtbar.
5.1.2. Die Wörterbücher
Die Datei [translations/messages+intl-icu.fr.yaml]:
Der Dateiname besteht aus drei Teilen: der Domäne ([messages], die Standarddomäne), dem Suffix [+intl-icu], das Meldungen im ICU-Format kennzeichnet, und der Sprache ([fr]). Die Schlüssel werden mithilfe der YAML-Verschachtelung nach Themen gruppiert: Der Menüeintrag „Accueil“ hat den Schlüssel [MENU.HOME], wobei die Ebenen durch einen Punkt getrennt sind. Ein Text kann Parameter enthalten, geschrieben als [{name}], die bei der Übersetzung ersetzt werden.
- Zeile 9: Apostrophe begrenzen einen YAML-String; sie sind notwendig, wenn der Text Zeichen enthält, die YAML interpretiert (geschweifte Klammern, Doppelpunkte usw.);
- Zeile 15: eine Plural-Meldung. [{n, plural, ...}] wählt anhand des Werts des Parameters [n] eine Form aus: [=0] für genau 0, [one] für den Singular, [other] für den Plural; [#] wird durch die Zahl ersetzt. Die Pluralregeln hängen von der Sprache ab, und ICU kennt sie: Im Französischen sind 0 und 1 Singular, im Englischen dagegen ist 0 Plural („0 products“). Das ist eine Verbesserung gegenüber dem „product(s)“ aus früheren Versionen der Fallstudie.
Die Datei [translations/messages+intl-icu.en.yaml] hat genau dieselben Schlüssel:
Ohne das Suffix [+intl-icu] würden die Parameter als [%name%] geschrieben, und der Plural verwendete eine für [Symfony] spezifische Syntax ([{0} Aucun produit|{1} Un produit|]1, Inf[ %n% produits]). Das ICU-Format ist dasjenige, das derzeit von der [Symfony]-Dokumentation empfohlen wird.
5.1.3. Die Sprache jeder Anfrage: src/EventListener/SetLanguage.php
Dies ist der [SetLanguage]-Listener aus Beispiel 16, der die Sprache diesmal aus einem Cookie bezieht:
- Zeile 11: der [kernel.request]-Ereignis-Listener mit Priorität 20: nach dem Routing, aber vor den [Symfony]-Listenern, die die Sprache der Anfrage verwenden (Beispiel 16);
- Zeilen 15–17: die unterstützten Sprachen und der Cookie-Name: öffentliche Klassenkonstanten, die aus anderen Klassen zugänglich sind ([SetLanguage::LANGUAGES]);
- Zeilen 22–24: die Sprache der Anfrage: die Sprache des [language]-Cookies, sofern vorhanden und unterstützt; andernfalls Englisch. [$request->cookies] ist die Menge der vom Browser gesendeten Cookies (Beispiel 05); [get] liefert den Wert eines Cookies oder [null]. [in_array] vergleicht mit [true] als drittem Parameter auch die Typen ([===]). [setLocale] legt die Sprache der Anfrage fest: Das ist die Sprache, die der Translator, unsere Formatierungsfilter und der Filter [format_currency] von [Twig] verwenden.
Anders als [Laravel] verschlüsselt [Symfony] Cookies nicht: Das Cookie [language] wird im Klartext übertragen. Das ist unproblematisch: Es enthält keine vertraulichen Informationen, und der Server akzeptiert nur unterstützte Sprachen. Das folgende Beispiel greift die Frage wieder auf, wie viel Vertrauen man einem Cookie schenken kann.
5.1.4. Sprachauswahl: src/Controller/LanguageController.php
- Zeile 17: die Route [/language/{code}]. Die Option [requirements] (Beispiel 02) beschränkt den Parameter auf die beiden unterstützten Sprachen: [/language/de] entspricht keiner Route und liefert einen 404-Fehler;
- Zeile 20: Die Aktion antwortet mit einer Weiterleitung auf die Seite, von der der Benutzer kam: Der Benutzer wird in der neuen Sprache auf seine Seite zurückgeführt;
- Zeilen 23–26: Die Antwort enthält ein Cookie, das der Browser bei jeder Anfrage zurücksendet. Die Klasse [Cookie] von [Symfony] beschreibt es: [Cookie::create(name, value)] erstellt es, und jede Methode von [with...] liefert eine veränderte Kopie (ein unveränderliches Objekt; siehe Beispiel 03): [withExpires], das Ablaufdatum (in einem Jahr); [withHttpOnly(true)] macht es für das [JavaScript] auf der Seite unsichtbar; [withSameSite(Cookie::SAMESITE_LAX)] verhindert, dass der Browser es mit einer POST-Anfrage von einer anderen Website sendet. ([httpOnly] und [lax] sind übrigens die Standardwerte von [Cookie::create].) [$response->headers->setCookie] fügt es der Antwort als [Set-Cookie]-Header hinzu;
- Zeilen 33–44: Die ursprüngliche Seite wird durch den Header [Referer] in der Anfrage angegeben (die falsch geschriebene Variante mit nur einem [r] ist die im HTTP-Standard verwendete), den der Browser mit der URL der Seite befüllt, die den Link enthielt. Dieser Header stammt jedoch vom Client, der beliebige Inhalte hineinschreiben kann. Blind auf diese Adresse weiterzuleiten, würde unsere Anwendung zu einem Open Redirect machen: Ein bösartiger Link mit unserem Domainnamen könnte den Benutzer auf eine schädliche Website schicken. Deshalb behalten wir nur den Pfad und die Parameter der URL (die Funktion [parse_url] von [PHP] zerlegt sie in einem assoziativen Array in ihre Bestandteile) und weisen jeden Pfad zurück, der mit [//] beginnt, was der Browser als Adresse einer anderen Website interpretieren würde.
5.1.5. Aktionen: src/Controller/PagesController.php
Die Aktionen sind sprachunabhängig: Sie liefern Rohdaten (einen Namen, ein Datum, Beträge in Cent). Übersetzung und Formatierung übernehmen die Views. Die Klasse [Product] hat einen Namen und einen Preis in Cent; die Erweiterung [FormatsExtension] ist die aus Beispiel 16: Ihr Filter [long_date] schreibt ein Datum im „vollständigen“ Format der Anfragesprache („Wednesday, September 23, 2026“, „mercredi 23 septembre 2026“), und ihr Filter [money] schreibt einen Betrag.
5.1.6. Übersetzen in den Views
- Zeile 3: Das Attribut [lang] der Seite teilt Browsern, Suchmaschinen und Screenreadern ihre Sprache mit; [app.request.locale] ist die Sprache der Anfrage;
- Zeile 8: Der Seitentitel wird von der Seite selbst geliefert, bereits übersetzt (Block [title]).
- Zeilen 4–5: Der Filter [trans] übersetzt einen Schlüssel in die Sprache der Anfrage;
- Zeilen 9–12: ein Button pro Sprache, der die Aktion [/language/{code}] auslöst. Die aktuelle Sprache ist hervorgehoben ([btn-primary], ausgefüllter Button).
- Zeile 2: der übersetzte [title]-Block für das Template;
- Zeile 7: Die Parameter für einen Text werden in einem assoziativen Array übergeben, einem Parameter des Filters [trans]; [{name}] wird durch den Wert des Schlüssels [name] ersetzt;
- Zeile 9: das Datum, formatiert in der Anfragesprache vom Filter [long_date] und dann als Parameter übergeben.
- Zeile 13: der Filter [money], dessen Ergebnis von der Sprache abhängt;
- Zeile 19: der Parameter [n] für die Pluralform der Meldung: die Anzahl der Produkte ([length], Beispiel 14). Die Produktnamen selbst werden nicht übersetzt: Es sind Daten , die in einer realen Anwendung aus einer Datenbank stammen würden.
Außerhalb von Views ist der Translator ein Service vom Typ [TranslatorInterface], den eine Aktion oder ein Service per Dependency Injection erhalten kann: [$translator->trans('HOME.HELLO', ['name' => 'Marie'])].
5.1.7. Ausführung
Die Startseite auf Englisch (der Standardsprache), dann auf Französisch nach einem Klick auf den Button „FR“:


Die Produktseite in beiden Sprachen. Die Beträge folgen den Konventionen der jeweiligen Sprache:


Der Sprachwechsel, betrachtet mit [curl]. Die Option [-H] liefert den Header [Referer] , den der Browser senden würde:
Die Weiterleitung führt zur ursprünglichen Seite zurück ([Symfony] schreibt eine relative URL, die der Browser vervollständigt), und das Cookie wird für ein Jahr gesetzt. Ein [Referer] , der auf eine andere Website verweist, führt nicht dorthin: Es wird nur sein Pfad beibehalten.
Die Seite [/trap] existiert auf unserer Website nicht: Der Benutzer erhält einen 404-Fehler, bleibt aber auf unserer Website. Schließlich die Startseite, angefordert mit dem Cookie [language=en] (Option [-b] von [curl]):
Eine andere Möglichkeit zur Wahl der Sprache wäre gewesen, den Header [Accept-Language] des Browsers auszulesen (Beispiel 12; [$request->getPreferredLanguage(['fr', 'en'])] wählt die beste Sprache aus den unterstützten aus). Beide werden oft kombiniert: die Browsersprache beim ersten Besuch, danach die vom Benutzer gewählte Sprache. Eine dritte Methode, die häufig mit [Symfony] verwendet wird, legt die Sprache in die URL ([/en/products]): Ein spezieller Routenparameter, [{_locale}], legt dann selbst die Sprache der Anfrage fest. Diese Fallstudie konzentriert sich auf das Cookie mit Englisch als Standardsprache.