Symfony 8.2 : extraire plus de messages à traduire

Ce qui se passe

La série « New in Symfony 8.2 » consacre un billet au composant Translation et à son intégration avec Twig et les formulaires. Le point central touche translation:extract.

L'extracteur voit enfin plus de messages

Jusqu'ici, la commande ne trouvait que les messages passés à trans(), t() ou new TranslatableMessage() sous forme de chaînes littérales, de concaténations de littéraux ou de constantes de classe. Tout autre cas échappait au catalogue, et la traduction manquante se découvrait en production. En 8.2, l'extracteur résout aussi :

• les ternaires et l'opérateur de coalescence nulle ;
• les expressions match ;
• les chaînes interpolées ;
• les variables assignées plus haut ;
• les valeurs renvoyées par des méthodes, quand il connaît la classe de l'objet ($this, paramètres et propriétés typés, cases d'enum, types de retour) et que la méthode est définie dans les chemins extraits.

Contribution de Guillaume Sainthillier. Côté Twig, il trouve aussi les messages passés à form_label(), form_widget(), form_help() et form_row(), dans le domaine de la variable translation_domain, à défaut dans le domaine par défaut. Le tag trans_default_domain est ignoré exprès, car les thèmes de formulaire ne s'en servent pas pour traduire libellés et aides (Nicolas Grekas).

Les autres changements

• XLIFF, élément <source>. translation:extract y écrivait la clé de traduction, alors que le format y attend le texte d'origine que voient traducteurs et outils. Symfony 8.2 le conserve au chargement et à l'écriture, et une nouvelle commande remplit les <source> avec les messages de la langue par défaut : pour navbar.home valant Home en anglais, <source> contiendra Home. Elle ne touche que translations/ et les chemins de framework.translator.paths, jamais les fichiers des vendors ou des bundles (Nicolas Rigaud et mauricedefelicec24).
• Domaine Twig pour tout le fichier. trans_default_domain ne couvre pas le corps des {% embed %}, compilés comme des gabarits séparés : un product.title se traduisait dans catalog, un product.add_to_cart dans messages. Le nouveau modificateur for _self applique le domaine à tout le fichier, embeds et macros compris. Le domaine doit être une chaîne littérale, déclaré une seule fois, hors de tout bloc et avant tout embed ; il ne s'étend pas aux gabarits inclus ou étendus (Matthias Pigulla).
• group_by de ChoiceType. Le callable peut renvoyer des objets TranslatableInterface, comme choice_label (Valentin Salmeron).

Comment s'y prendre

1. En passant à 8.2, relancez translation:extract et comparez le catalogue : de nouveaux messages vont apparaître.
2. Si votre thème de formulaire surcharge le bloc choice_widget_options, lisez le libellé du groupe dans choice.label, avec la clé de boucle en repli : la clé du tableau n'en est plus le libellé dès qu'on utilise des objets traduisibles.
3. Ajoutez for _self aux gabarits qui utilisent des embed, au lieu de répéter le domaine dans chaque corps.

Source : blog Symfony, en anglais.