New in Symfony 6.2: Better PHP Translation Extractor

Contributed by
Mathieu Santostefano
in #46161.

Symfony includes a translation:extract command that looks for translatable contents in Twig templates and PHP files/classes to update the translation files with all the new contents found.

Behind the scenes, a PhpExtractor service uses the token_get_all() function to find those translatable strings. This works well in most cases, but it's increasingly difficult to add support for newer PHP features such as named arguments.

That's why in Symfony 6.2 we're introducing a new AST-based translation extractor. It uses the popular nikic/php-parser library to properly parse the contents of PHP files and process them as traversable nodes.

The new PhpAstExtractor service supports all kinds of trans() function calls, usages of TranslatableMessage class, messages defined in validation constraints, etc. Thanks to its solid AST-based foundation, we'll improve it and will add support for new PHP features much faster than before.

To use the new translation extractor, update your project to Symfony 6.2 and install the nikic/php-parser package using Composer. That's all. There's nothing else to configure or change in your project.

            <hr style="margin-bottom: 5px" />
            <div style="font-size: 90%">
                <a href="https://symfony.com/sponsor">Sponsor</a> the Symfony project.
            </div>

https://symfony.com/blog/new-in-symfony-6-2-better-php-translation-extractor?utm_source=Symfony%20Blog%20Feed&utm_medium=feed

Created 3y | Nov 10, 2022, 9:20:08 AM


Login to add comment

Other posts in this group

New in Symfony 7.3: Extra Runtime Dot Env Files

Contributed by Nathan Page in

May 1, 2025, 8:40:12 AM | Symfony
SymfonyOnline June 2025: Where Have the Women of Tech History Gone?

SymfonyOnline June 2025 is almost here, starting in almost 2 months on:

June 10-11: Workshop days. It is possible to attend 1 two-day training or 2 one-day trainings. June 12-13: Online confe

Apr 30, 2025, 2:20:02 PM | Symfony
New in Symfony 7.3: Arbitrary User Permission Checks

Contributed by Nate Wiebe in

Apr 30, 2025, 9:30:12 AM | Symfony
SymfonyOnline June 2025: Automate Everything with Your Personal Army of Robots

SymfonyOnline June 2025 is almost here, starting in almost 2 months on:

June 10-11: Workshop days. It is possible to attend 1 two-day training or 2 one-day trainings. June 12-13: Online confe

Apr 29, 2025, 3:10:03 PM | Symfony
New in Symfony 7.3: Slug and Twig Constraints

The Validator component provides dozens of constraints ready to use in your applications. In Symfony 7.3, we've added two new constraints to the list.

Slug Constraint

Apr 29, 2025, 10:30:02 AM | Symfony
SymfonyOnline June 2025: Multi-Tenantize the Symfony components

SymfonyOnline June 2025 is almost here, starting in almost 2 months on:

June 10-11: Workshop days. It is possible to attend 1 two-day training or 2 one-day trainings. June 12-13: Online confe

Apr 28, 2025, 3:50:10 PM | Symfony
New in Symfony 7.3: Twig Extension Attributes

Contributed by Jérôme Tamarelle in

Apr 28, 2025, 8:50:09 AM | Symfony