Yaml Symfony Format
Symfonys YAML-Übersetzungsformat organisiert Locale-Dateien nach Domain – einer benannten Gruppe verwandter Zeichenketten. Jede Übersetzungs-Domain erhält ihre eigene Datei: messages.en.yaml, validators.fr.yaml, security.de.yaml. Dies ermöglicht verschiedenen Teilen der Anwendung, separate Übersetzungsdateien zu verwenden, die zur Laufzeit unabhängig geladen werden, was Nutzlastgrößen klein hält und gezielte Übersetzungszuweisungen ermöglicht.
Symfony-YAML-Dateien folgen der standardmäßigen YAML-eingerückten Schlüssel-Wert-Syntax, verwenden jedoch die domänenbasierte Dateibenennungskonvention, bei der der Locale-Code im Dateinamen eingebettet ist, anstatt an der Wurzel der YAML-Hierarchie. Symfony unterstützt das ICU-Nachrichtenformat für Pluralisierung und verwendet doppelt geschweifte Klammernsyntax für benannte Parameter.
Best Practice: Organisieren Sie Übersetzungsschlüssel nach Domain basierend auf dem Anwendungsbereich, anstatt alle Zeichenketten in die Standard-messages-Domain zu legen. Verwenden Sie den Symfony-Übersetzungsextraktionsbefehl, um Übersetzungsdateien aus Quellannotationen automatisch zu generieren. Fügen Sie Übersetzernotizen mit dem comment-Parameter des trans()-Tags hinzu – diese Notizen helfen Übersetzern, den Kontext zu verstehen, ohne den PHP-Quellcode einsehen zu müssen. Language Monster erkennt Symfony-YAML-Domain-Dateien anhand ihrer Namenskonvention und verarbeitet sowohl YAML-Struktur als auch Symfony-spezifische Pluralsyntax.