PHP-Internationalisierung: i18n für mehrsprachige Webseiten

Warum Ihre PHP-Website mehrere Sprachen sprechen sollte

Stellen Sie sich vor: Sie haben ein perfektes Produkt entwickelt – schnell, benutzerfreundlich und lösungsorientiert. Aber es gibt einen Haken: Ihre Oberfläche spricht nur Deutsch. Potenzielle Kunden aus Frankreich, Japan oder Brasilien schließen einfach den Tab, weil sie keinen Knopf verstehen. Das ist nicht nur entgangener Gewinn – das ist der Verlust ganzer Märkte.

Internationalisierung (i18n – von „internationalization", 18 Buchstaben zwischen i und n) und Lokalisierung (l10n) sind kein „Nice-to-have" für Startups, sondern ein strategisches Werkzeug. Viele Entwickler fürchten diesen Begriff und denken, sie müssten den gesamten Code umschreiben. In Wahrheit ist eine durchdachte Übersetzungsstruktur in PHP ein eleganter Prozess, der den Code sauberer und das Unternehmen globaler macht.

In diesem Artikel betrachten wir drei bewährte Ansätze zur Internationalisierung von PHP-Anwendungen: von einfachen Arrays über die leistungsstarke intl-Erweiterung bis hin zum klassischen gettext. Sie erfahren, wie Sie nicht nur Texte übersetzen, sondern auch Daten, Zahlen und Pluralformen korrekt verarbeiten – denn im Arabischen, Polnischen oder Russischen gelten andere Deklinationsregeln.

Die wichtigsten i18n-Ansätze in PHP

Bevor Sie Code schreiben, müssen Sie die Architektur wählen. Grundsätzlich lassen sich alle Methoden in drei Kategorien einteilen. Welche Sie wählen, hängt vom Projektumfang und den Leistungsanforderungen ab.

1. Arrays und INI-Dateien (DIY-Ansatz)

Der einfachste Weg: Übersetzungen in assoziativen Arrays oder .ini-Dateien speichern. Ideal für kleine Projekte oder MVPs.

// lang/de.php\nreturn [\n    'welcome' => 'Willkommen auf der Website!',\n    'logout' => 'Abmelden',\n    'cart_empty' => 'Der Warenkorb ist leer'\n];\n\n// lang/en.php\nreturn [\n    'welcome' => 'Welcome to the website!',\n    'logout' => 'Logout',\n    'cart_empty' => 'Cart is empty'\n];

Die Nutzung ist simpel: Je nach Session oder Cookie des Benutzers wird die passende Datei geladen.

function __($key) {\n    static $lang = null;\n    if ($lang === null) {\n        $locale = $_SESSION['lang'] ?? 'de';\n        $lang = include "lang/{$locale}.php";\n    }\n    return $lang[$key] ?? $key;\n}\n\necho __('welcome'); // Willkommen auf der Website!

Vorteile: Einfachheit, keine Erweiterungen nötig, leicht cachebar (sogar in Redis speicherbar).
\nNachteile: Keine Unterstützung für Pluralformen (Sie müssten eine Eigenentwicklung schreiben), ungeeignet für große Projekte (tausende Schlüssel in einer Datei).

2. Gettext – der Klassiker

Gettext ist der De-facto-Standard für Internationalisierung in der Unix-Welt. In PHP ist es über die gettext-Erweiterung verfügbar. Dieses mächtige Werkzeug wird in WordPress, Drupal und Symfony eingesetzt.

Zunächst erstellen Sie .po-Dateien (z. B. für Deutsch):

# de_DE/LC_MESSAGES/messages.po\nmsgid "Hello, %s!"\nmsgstr "Hallo, %s!"\n\nmsgid "You have %d new message"\nmsgid_plural "You have %d new messages"\nmsgstr[0] "Sie haben %d neue Nachricht"\nmsgstr[1] "Sie haben %d neue Nachrichten"

Anschließend kompilieren Sie die Datei mit dem Tool msgfmt in das .mo-Format. Im PHP-Code sieht das so aus:

putenv('LC_ALL=de_DE.UTF-8');\nsetlocale(LC_ALL, 'de_DE.UTF-8');\nbindtextdomain('messages', './locale');\ntextdomain('messages');\n\necho gettext('Hello, %s!', 'Max'); // Hallo, Max!\n\n// Pluralformen – wie von Zauberhand:\necho ngettext('%d message', '%d messages', 3); // 3 Nachrichten

Übrigens: Nutzen Sie Poedit, um die Entwicklung zu beschleunigen – es hebt unübersetzte Zeilen hervor.

3. Die Intl-Erweiterung (PHP 5.3+)

Wenn Sie nicht nur Texte übersetzen, sondern auch Zahlen, Daten oder Währungen länderspezifisch formatieren möchten, verwenden Sie Intl. Es baut auf der ICU-Bibliothek (International Components for Unicode) auf.

// Zahlen formatieren