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.