Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Symfony : le composant Translation

Tout le reste de ce chapitre traduit du contenu, ce qu’un rĂ©dacteur a Ă©crit. Le composant Translation de Symfony rĂ©sout un problĂšme plus Ă©troit : l’interface de l’application elle-mĂȘme, les libellĂ©s, les boutons et les messages d’erreur qui vivent dans le code.

composer require symfony/translation
# translations/messages.en.yaml
welcome_message: "Welcome back, %name%!"
cart.empty: "Your cart is empty."
# translations/messages.fr.yaml
welcome_message: "Content de vous revoir, %name% !"
cart.empty: "Votre panier est vide."
<h1>{{ 'welcome_message'|trans({'%name%': user.firstName}) }}</h1>
$message = $translator->trans('cart.empty');

La locale active se fixe Ă  chaque requĂȘte, d’aprĂšs un prĂ©fixe d’URL, une prĂ©fĂ©rence de l’utilisateur ou l’en-tĂȘte Accept-Language. Tout ce qui passe par trans() la suit.

Quand le choisir

Toute application Symfony dont l’interface doit parler plusieurs langues : libellĂ©s, messages de validation, modĂšles d’e-mail, navigation. Pour une application Symfony avec des utilisateurs Ă  l’international, c’est la pratique normale, pas une fonctionnalitĂ© avancĂ©e.

Quand ce n’est pas le bon outil

Le contenu Ă©ditorial, articles de blog ou fiches produit. C’est le problĂšme que rĂ©solvent les arbres de contenu multilingues de TYPO3 ou WPML. Ce composant n’a aucune notion de contenu, seulement de clĂ©s de message.

Sous le capot : les fichiers de traduction sont chargĂ©s une fois et mis en cache sous forme de tableaux PHP compilĂ©s dans le rĂ©pertoire de cache de Symfony. En production, retrouver une chaĂźne traduite est une lecture dans un tableau, pas une lecture de fichier ni une requĂȘte en base, mĂȘme avec des centaines de clĂ©s dans une douzaine de langues.