PHP
Übersetze Zeichenfolgenliterale in statischen PHP-Spracharrays, ohne Anwendungscode auszuführen.
PHP-Anwendungen laden Meldungen häufig aus einer Datei, die ein Array zurückgibt. Der php-Dateihandler übersetzt die Zeichenfolgenliterale in diesem Array und behält Zugriffsschlüssel, Kommentare, Zahlen und die umgebende Syntax bei. Dabei analysiert er die Datei, ohne PHP auszuführen.
Unterstützte Quellstruktur #
Zum Beispiel:
<?php
return [
'checkout' => [
'title' => 'Complete your order',
'delivery' => 'Delivery within :days days',
],
];Die Textpfade sind checkout.title und checkout.delivery. Unterstützt werden verschachtelte Arrays mit eckigen Klammern sowie die array(...)-Syntax. Die Zeichenfolgenschlüssel bleiben unverändert, sodass die Anwendung weiterhin über dieselben Bezeichner auf die Werte zugreift.
Speichere Meldungswerte in statischen Arrays. Verkettungen, Funktionsaufrufe und aus Variablen abgeleitete Zeichenfolgen erfordern eine Auswertung, die dieser Scanner nicht durchführt. Ein Literal in der Nähe eines Ausdrucks ist nicht dessen berechnetes Ergebnis. Lege solche Meldungen als literale Ressourcenwerte ab, bevor du dich darauf verlässt, dass die Dateiübersetzung sie erfasst.
Anführungszeichen und vorhandene Zielwerte #
Der Handler behält die einfachen oder doppelten Anführungszeichen jeder Quellzeichenfolge bei und maskiert die Ersatzwerte entsprechend. Ausgaben in doppelten Anführungszeichen behalten Interpolationstokens bei, die bereits in der Quelle vorhanden sind, etwa {$name}, und maskieren neu hinzugekommene Dollarzeichen-Sequenzen. Teste Anwendungsplatzhalter wie :days mit den Werten, die der aufrufende Code übergibt.
Der inkrementelle Vergleich verwendet den Pfad jedes Literals im zurückgegebenen Array. Unveränderte Quellmeldungen können ihre akzeptierten Zielwerte behalten. Ändert sich ein Schlüssel, ändert sich auch die für den Vergleich verwendete Identität – selbst wenn der englische Text gleich bleibt. Mit der Schlüsselsteuerung der CLI kannst du Quellwerte sperren, Zielwerte beibehalten und ignorierte Einträge aus PHP-Dateien entfernen.
Die schlüsselbezogene Rekonstruktion kann nicht aufgelöste assoziative Einträge ohne Zielwert entfernen. Gehe nicht davon aus, dass ein Teildurchlauf eine vollständige Sprachdatei erzeugt. Führe eine Prüfung der verschachtelten Strukturen und aller positionsabhängigen Werte durch, die deine Anwendung erwartet.
Datei konfigurieren und validieren #
Die CLI leitet php aus .php ab. Wähle über die CLI-Konfiguration oder GitHub die Dateien der Quellsprache und ihre Zielpfade aus.
Führe php -l für die Zieldatei aus und lade anschließend ihre Meldungen in der Anwendung. Gib parametrisierte Texte mit den Werten aus, die der aufrufende Code übergibt. Bei Laravel werden die Sprachauswahl pro Anfrage und die Rückfallsprache weiterhin in der Anwendung konfiguriert; Eine Web-App lokalisieren zeigt, wie die übersetzte Ressource mit diesen Schritten verknüpft wird.