5. Internationalisierung
Eine internationalisierte Anwendung zeigt ihre Texte in der Sprache des Benutzers an. Die Fallstudie ist auf Französisch und Englisch. Das Prinzip ist einfach: Die Views enthalten keinen Text mehr, sondern Schlüssel ([MENU.HOME]), und ein Wörterbuch für jede Sprache ordnet jedem Schlüssel einen Text zu. Die gewählte Sprache wird in einem Cookie gespeichert.
[Laravel] hat ein eigenes Übersetzungssystem, dem wir bereits in Beispiel 09 bei den Validierungsmeldungen begegnet sind. Es akzeptiert zwei Arten von Wörterbüchern, die im Ordner [lang] liegen: [PHP]-Dateien, eine pro Thema und pro Sprache ([lang/fr/validation.php]), die ein Array von Schlüsseln zurückgeben; und JSON-Dateien, eine pro Sprache ([lang/fr.json]), in denen jeder Schlüssel eine beliebige Zeichenkette ist. Wir verwenden das zweite Format: Abgesehen von der Syntax der Parameter sind das dieselben Wörterbücher wie in den Versionen [ASP.NET Core MVC], [NestJS], [Spring MVC] und [Flask] der Fallstudie, und ihr Format lässt sich ohne besondere Werkzeuge lesen und schreiben. Die Formatierung von Datumsangaben und Beträgen bleibt dieselbe wie in Beispiel 16.
5.1. Beispiel 22: Eine zweisprachige Anwendung
| 22-i18n/
├── app/
│ ├── Helpers/
│ │ └── Formats.php
│ ├── Http/
│ │ ├── Controllers/
│ │ │ ├── LanguageController.php
│ │ │ └── PagesController.php
│ │ └── Middleware/
│ │ └── SetLanguage.php
│ └── Models/
│ └── Product.php
├── lang/
│ ├── en.json
│ └── fr.json
├── resources/
│ └── views/
│ ├── fragments/
│ │ └── navbar.blade.php
│ ├── layout.blade.php
│ └── pages/
│ ├── home.blade.php
│ └── products.blade.php
└── ...
|
5.1.1. Die Wörterbücher
Die Datei [lang/fr.json]:
| {
"MENU.HOME": "Accueil",
"MENU.PRODUCTS": "Produits",
"HOME.TITLE": "Bienvenue",
"HOME.HELLO": "Bonjour :name !",
"HOME.DATE": "Nous sommes le :date.",
"PRODUCTS.TITLE": "Nos produits",
"PRODUCTS.NAME": "Produit",
"PRODUCTS.PRICE": "Prix",
"PRODUCTS.COUNT": ":n produit(s) au catalogue."
}
|
Ein JSON-Wörterbuch ist ein Objekt, in dem jedes Paar einen Schlüssel einem Text zuordnet. Die Schlüssel sind anhand ihres Präfixes nach Themen gruppiert: Der Menütext „Accueil“ hat den Schlüssel [MENU.HOME]. Ein Text kann Platzhalter enthalten, geschrieben als [:name], die bei der Übersetzung ersetzt werden. (Die Wörterbücher der anderen Versionen der Fallstudie verschachteln die JSON-Objekte – [{"MENU": {"HOME": "Accueil"}}] – und schreiben die Parameter als [{name}]; die von [Laravel] sind „flach“ und verwenden die Syntax [:name].) Die Datei [lang/en.json] hat genau dieselben Schlüssel:
| {
"MENU.HOME": "Home",
"MENU.PRODUCTS": "Products",
"HOME.TITLE": "Welcome",
"HOME.HELLO": "Hello :name!",
"HOME.DATE": "Today is :date.",
"PRODUCTS.TITLE": "Our products",
"PRODUCTS.NAME": "Product",
"PRODUCTS.PRICE": "Price",
"PRODUCTS.COUNT": ":n product(s) in the catalogue."
}
|
Fehlt ein Schlüssel im JSON-Wörterbuch der aktuellen Sprache, wird er in den [PHP]-Dateien dieser Sprache gesucht ([lang/fr/*.php], Beispiel 09) und anschließend in denen der Ausweichsprache ([APP_FALLBACK_LOCALE], standardmäßig Englisch). Ein Ausweich-Wörterbuch (JSON) gibt es nicht: Ein Schlüssel, der weder im (JSON-)Wörterbuch der aktuellen Sprache noch in diesen Dateien vorkommt, wird unverändert angezeigt. So ist jedes Versäumnis sofort auf dem Bildschirm sichtbar.
5.1.2. Die Sprache jeder Anfrage: app/Http/Middleware/SetLanguage.php
| <?php
// app/Http/Middleware/SetLanguage.php: die Sprache jeder Anfrage
namespace App\Http\Middleware;
use Closure;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\App;
use Symfony\Component\HttpFoundation\Response;
class SetLanguage
{
// die unterstützten Sprachen; die erste ist die Standardsprache
public const LANGUAGES = ['en', 'fr'];
public const COOKIE = 'language';
// die Sprache des Cookies [language], falls sie unterstützt wird, sonst Englisch
public function handle(Request $request, Closure $next): Response
{
$language = $request->cookie(self::COOKIE);
App::setLocale(in_array($language, self::LANGUAGES, true) ? $language : self::LANGUAGES[0]);
return $next($request);
}
}
|
- Zeilen 14–16: die unterstützten Sprachen und der Cookie-Name: öffentliche Klassenkonstanten, auf die andere Klassen zugreifen können ([SetLanguage::LANGUAGES]);
- Zeilen 21–22: Vor jeder Aktion die Sprache der Anfrage: die Sprache aus dem Cookie [language], sofern vorhanden und unterstützt; andernfalls Englisch. [$request->cookie(name)] liefert den Wert eines vom Browser gesendeten Cookies oder [null]. [in_array] vergleicht mit [true] als drittem Parameter auch die Typen ([===]). [App::setLocale] (Beispiel 16) legt die Sprache der Anwendung für die Anfrage fest: Das ist die Sprache, die für Übersetzungen und Formatierung verwendet wird.
5.1.3. Die Konfiguration: bootstrap/app.php
| <?php
// bootstrap/app.php: die Anwendung von Beispiel 22
use App\Http\Middleware\SetLanguage;
use Illuminate\Foundation\Application;
use Illuminate\Foundation\Configuration\Middleware;
use Illuminate\Support\Facades\Blade;
(require __DIR__.'/../../vendor/autoload.php')->addPsr4('App\\', __DIR__.'/../app/');
return Application::configure(basePath: dirname(__DIR__))
->withRouting(
web: __DIR__.'/../routes/web.php',
// die Route, die Bootstrap ausliefert (siehe Beispiel 15)
then: fn () => require __DIR__.'/../../common/bootstrap.php')
->withMiddleware(function (Middleware $middleware): void {
// das Cookie [language] ist nicht verschlüsselt: es enthält nichts Geheimes, und
// der Server akzeptiert nur die unterstützten Sprachen
$middleware->encryptCookies(except: [SetLanguage::COOKIE]);
// die Sprache jeder Anfrage: die des Cookies [language], sonst Englisch
$middleware->web(append: SetLanguage::class);
})
->withExceptions()
->booted(function () {
// in den Views: @money($price) (siehe Beispiel 16)
Blade::directive('money', fn (string $expression) =>
"<?php echo e(\\App\\Helpers\\Formats::money($expression)); ?>");
})
->create();
|
- Zeile 19: Standardmäßig verschlüsselt [Laravel] alle Cookies, die es setzt, und entschlüsselt die, die es empfängt (das ist die Aufgabe der Middleware [EncryptCookies] in der Gruppe [web]; siehe Beispiel 20): Der Benutzer kann ein verschlüsseltes Cookie weder lesen noch erzeugen. Das Cookie [language] enthält keine geheimen Informationen, und der Server akzeptiert nur unterstützte Sprachen: Wir nehmen es von der Verschlüsselung aus, sodass wir es mit [curl] ansehen (und erzeugen) können. Das folgende Beispiel greift diese Verschlüsselung wieder auf;
- Zeile 21: die Sprach-Middleware am Ende der Gruppe [web] (Beispiel 16): Sie läuft nach [EncryptCookies] und liest daher bereits entschlüsselte Cookies;
- Zeilen 26–27: die Direktive [@money] aus Beispiel 16.
Die Klasse [App\Helpers\Formats] ist die aus Beispiel 16, mit einem Unterschied: Das Datum wird für jede Sprache im „langen“ Format formatiert:
| <?php
// app/Helpers/Formats.php: Daten und Beträge, formatiert in der Sprache der Anfrage (siehe Beispiel 16)
namespace App\Helpers;
use Brick\Math\BigDecimal;
use Carbon\CarbonInterface;
use Illuminate\Support\Facades\App;
use Illuminate\Support\Number;
class Formats
{
// ein Betrag in Euro
public static function money(BigDecimal $amount): string
{
return Number::currency($amount->toFloat(), in: 'EUR', locale: App::getLocale());
}
// ein Datum in ausgeschriebenen Worten. Das Format "dddd LL": der Wochentag, dann das
// Datum im "langen" Format der Sprache: "mercredi 23 septembre 2026" auf Französisch,
// "Wednesday September 23, 2026" auf Englisch
public static function longDate(CarbonInterface $day): string
{
return $day->locale(App::getLocale())->isoFormat('dddd LL');
}
}
|
- Zeile 24: [LL] ist ein lokalisiertes Format: Jede Sprache hat ihr eigenes ([23 septembre 2026] auf Französisch, [September 23, 2026] auf Englisch), wohingegen [D MMMM YYYY] allen Sprachen die französische Reihenfolge aufzwingen würde. [dddd] fügt den Wochentag hinzu.
5.1.4. Sprachauswahl: app/Http/Controllers/LanguageController.php
| <?php
// app/Http/Controllers/LanguageController.php: die Wahl der Sprache
namespace App\Http\Controllers;
use App\Http\Middleware\SetLanguage;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
class LanguageController
{
// GET /language/fr: speichert die Wahl in einem Cookie und kehrt dann zur vorherigen Seite zurück
public function change(Request $request, string $code): RedirectResponse
{
abort_unless(in_array($code, SetLanguage::LANGUAGES, true), 404);
// das Cookie: ein Jahr Lebensdauer (in Minuten), vom JavaScript der
// Seite nicht lesbar (httpOnly), nie mit einer POST-Anfrage von einer anderen Website gesendet (sameSite)
return redirect(self::originPage($request))
->withCookie(cookie(SetLanguage::COOKIE, $code, 365 * 24 * 60, httpOnly: true, sameSite: 'lax'));
}
// die Seite, von der wir kommen (Header Referer), von der wir nur den Pfad behalten:
// eine Weiterleitung auf eine vollständige Adresse aus der Anfrage würde es ermöglichen,
// den Benutzer auf eine andere Website zu schicken (Schwachstelle "Open Redirect")
private static function originPage(Request $request): string
{
// parse_url zerlegt eine URL in ihre Bestandteile (Pfad, Parameter...)
$url = parse_url($request->header('Referer', ''));
$path = $url['path'] ?? '';
// "//site.com/..." würde vom Browser als Adresse
// auf einer ANDEREN Website verstanden: ebenfalls abgelehnt
if (! str_starts_with($path, '/') || str_starts_with($path, '//')) {
return '/';
}
return isset($url['query']) ? "$path?{$url['query']}" : $path;
}
}
|
- Zeile 15: ein unbekannter Sprachcode: 404;
- Zeilen 18–19: Die Aktion antwortet mit einer Weiterleitung auf die Seite, von der der Benutzer kam; der Benutzer wird in der neuen Sprache auf diese Seite zurückgeführt. Die Antwort enthält ein Cookie, das der Browser mit jeder Anfrage zurücksendet: Die Funktion [cookie] erzeugt es, und die Methode [withCookie] fügt es der Antwort hinzu. Seine Parameter: der Name, der Wert, die Lebensdauer in Minuten (ein Jahr) und zwei benannte Parameter: [httpOnly: true] macht es für das [JavaScript] der Seite unsichtbar; [sameSite: 'lax'] verhindert, dass der Browser es bei einer POST-Anfrage sendet, die von einer anderen Website stammt;
- Zeilen 25–36: Die ursprüngliche Seite wird durch den Header [Referer] der Anfrage angegeben (die falsch geschriebene Variante mit nur einem [r] ist die, die im HTTP-Standard verwendet wird), den der Browser mit der URL der Seite füllt, die den Link enthielt. Dieser Header stammt jedoch vom Client, der beliebige Inhalte hineinschreiben kann. Blind auf diese Adresse umzuleiten, würde unsere Anwendung zu einem *Open Redirect* machen: Ein bösartiger Link mit unserem Domainnamen könnte den Benutzer auf eine bösartige Website schicken. Deshalb behalten wir nur den Pfad und die Parameter der URL (die Funktion [parse_url] von [PHP] zerlegt sie in ihre Bestandteile und legt sie in einem assoziativen Array ab) und weisen jeden Pfad zurück, der mit [//] beginnt, was der Browser als Adresse einer anderen Website interpretieren würde. [Laravel] bietet außerdem [redirect()->back()] (oder [back()]), das auf die in der Session gespeicherte vorherige Seite umleitet (Beispiel 20) und nicht auf den Header [Referer]: Das werden wir in der Fallstudie verwenden.
5.1.5. Aktionen: app/Http/Controllers/PagesController.php
| <?php
// app/Http/Controllers/PagesController.php: die Actions wissen nichts über die Sprache:
// sie liefern Daten, die Views übersetzen und formatieren sie
namespace App\Http\Controllers;
use App\Models\Product;
use Brick\Math\BigDecimal;
use Carbon\CarbonImmutable;
use Illuminate\View\View;
class PagesController
{
public function home(): View
{
return view('pages.home', ['name' => 'Marie',
'today' => CarbonImmutable::create(2026, 9, 23)]);
}
public function products(): View
{
return view('pages.products', ['products' => [
new Product('Keyboard', BigDecimal::of('25')),
new Product('Mouse', BigDecimal::of('12.5')),
new Product('Screen', BigDecimal::of('1149')),
]]);
}
}
|
Die Aktionen sind sprachunabhängig: Sie liefern Rohdaten (einen Namen, ein Datum, Beträge). Übersetzung und Formatierung übernehmen die Views.
5.1.6. Übersetzen in den Views
| <!doctype html>
{{-- app()->getLocale(): the language of the request, "en" or "fr" --}}
<html lang="{{ app()->getLocale() }}">
<head>
<meta charset="utf-8">
{{-- the title: the [title] section of the page, already translated --}}
<title>@yield('title')</title>
<link rel="stylesheet" href="{{ route('bootstrap', 'css/bootstrap.min.css') }}">
<link rel="stylesheet" href="{{ asset('css/styles.css') }}">
</head>
<body>
<div class="container py-3">
@include('fragments.navbar')
<main>
@yield('content')
</main>
</div>
</body>
</html>
|
- Zeile 3: Das Attribut [lang] der Seite gibt Browsern, Suchmaschinen und Screenreadern ihre Sprache an;
- Zeile 7: Der Seitentitel wird von der Seite selbst geliefert, bereits übersetzt (Abschnitt [title]).
| <nav class="navbar navbar-expand bg-light rounded mb-3 px-3">
<div class="navbar-nav me-auto">
{{-- __('KEY'): the translation of a key, in the language of the request --}}
<a class="nav-link" href="/">{{ __('MENU.HOME') }}</a>
<a class="nav-link" href="/products">{{ __('MENU.PRODUCTS') }}</a>
</div>
{{-- the current language is highlighted --}}
<div class="btn-group btn-group-sm">
@foreach (['fr', 'en'] as $code)
<a @class(['btn', 'btn-primary' => app()->isLocale($code), 'btn-outline-primary' => ! app()->isLocale($code)])
href="/language/{{ $code }}">{{ strtoupper($code) }}</a>
@endforeach
</div>
</nav>
|
- Zeilen 4–5: Die Funktion [__] (mit zwei Unterstrichen) liefert die Übersetzung eines Schlüssels in der Sprache der Anfrage;
- Zeilen 9–12: ein Button pro Sprache, der die Aktion [/language/{code}] auslöst. Die aktuelle Sprache wird hervorgehoben ([btn-primary], ausgefüllter Button): [app()->isLocale($code)] prüft die Sprache der Anfrage.
| @extends('layout')
@section('title', __('HOME.TITLE'))
@section('content')
<h1>{{ __('HOME.TITLE') }}</h1>
{{-- a parameter: the second parameter of __, an array --}}
<p>{{ __('HOME.HELLO', ['name' => $name]) }}</p>
{{-- the date, formatted first, then passed as the [date] parameter --}}
<p>{{ __('HOME.DATE', ['date' => App\Helpers\Formats::longDate($today)]) }}</p>
@endsection
|
- Zeile 2: der übersetzte Abschnitt [title] für das Template;
- Zeile 7: Die Parameter für einen Text werden in einem assoziativen Array übergeben, dem zweiten Parameter von [__]; [:name] wird durch den Wert des Schlüssels [name] ersetzt;
- Zeile 9: das Datum, formatiert in der Sprache der Anfrage mit der Methode [longDate] und dann als Parameter übergeben. Eine Direktive ([@longDate]) kann hier nicht verwendet werden: Sie schreibt direkt in die Seite und liefert keinen Wert zurück.
| @extends('layout')
@section('title', __('PRODUCTS.TITLE'))
@section('content')
<h1>{{ __('PRODUCTS.TITLE') }}</h1>
<table class="table table-sm w-auto">
<thead><tr><th>{{ __('PRODUCTS.NAME') }}</th><th class="text-end">{{ __('PRODUCTS.PRICE') }}</th></tr></thead>
<tbody>
@foreach ($products as $product)
<tr>
<td>{{ $product->name }}</td>
<td class="text-end">@money($product->price)</td>
</tr>
@endforeach
</tbody>
</table>
<p>{{ __('PRODUCTS.COUNT', ['n' => count($products)]) }}</p>
@endsection
|
- Zeile 17: ein berechneter Parameter. Die Produktnamen werden dagegen nicht übersetzt: Es sind Daten , die in einer realen Anwendung aus einer Datenbank kämen.
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, gesehen mit [curl]. Die Option [-H] liefert den Header [Referer] , den der Browser senden würde:
| curl -i -H "Referer: http://localhost:8000/products" http://localhost:8000/language/en
|
| HTTP/1.1 302 Found
Location: http://localhost:8000/products
Set-Cookie: language=en; expires=Sun, 26 Sep 2027 16:18:24 GMT; Max-Age=31536000; path=/; httponly; samesite=lax
...
|
Die Weiterleitung führt Sie auf die ursprüngliche Seite zurück, und das Cookie wird für ein Jahr im Klartext gesetzt. Ein [Referer] , der auf eine andere Website verweist, leitet Sie nicht dorthin um: Nur sein Pfad wird behalten.
| curl -i -H "Referer: https://pirate.example/trap" http://localhost:8000/language/en
curl -i -H "Referer: http://localhost:8000//pirate.example/x" http://localhost:8000/language/fr
|
| HTTP/1.1 302 Found
Location: http://localhost:8000/trap
...
HTTP/1.1 302 Found
Location: http://localhost:8000
...
|
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]); da Englisch die Standardsprache ist, ist die Seite dieselbe wie ohne das Cookie:
| curl -b "language=en" http://localhost:8000/
|
| <!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Welcome</title>
...
<a class="nav-link" href="/">Home</a>
<a class="nav-link" href="/products">Products</a>
...
<h1>Welcome</h1>
<p>Hello Marie!</p>
<p>Today is Wednesday September 23, 2026.</p>
...
|
Eine andere Möglichkeit, die Sprache auszuwählen, wäre gewesen, den Header [Accept-Language] des Browsers zu lesen (Beispiel 12). Beides wird oft kombiniert: die Sprache des Browsers beim ersten Besuch, danach die Sprache, die der Benutzer gewählt hat. Diese Fallstudie konzentriert sich auf das Cookie, mit Englisch als Standard.