New in Symfony 6.2: Better PHP Translation Extractor
November 10, 2022
•
Published by
Javier Eguiluz
Symfony 6.2 is backed by:
Warning: This post is about an unsupported Symfony version. Some of this information may be out of date. Read the most recent Symfony Docs.
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.
Help the Symfony project!
As with any Open-Source project, contributing code or documentation is the most common way to help, but we also have a wide range of sponsoring opportunities.
Comments are closed.
To ensure that comments stay relevant, they are closed for old posts.