How to Find Errors in Translation Files

Warning: You are browsing the documentation for Symfony 4.x, which is no longer maintained.

Read the updated version of this page for Symfony 7.2 (the current stable version).

Symfony processes all the application translation files as part of the process that compiles the application code before executing it. If there's an error in any translation file, you'll see an error message explaining the problem.

If you prefer, you can also validate the contents of any YAML and XLIFF translation file using the lint:yaml and lint:xliff commands:

        1
2
3
4
5
6
7
8
9
10
11
        # lint a single file
$ php bin/console lint:yaml translations/messages.en.yaml
$ php bin/console lint:xliff translations/messages.en.xlf

# lint a whole directory
$ php bin/console lint:yaml translations
$ php bin/console lint:xliff translations

# lint multiple files or directories
$ php bin/console lint:yaml translations path/to/trans
$ php bin/console lint:xliff translations/messages.en.xlf translations/messages.es.xlf
    

The linter results can be exported to JSON using the --format option:

        1
2
        $ php bin/console lint:yaml translations/ --format=json
$ php bin/console lint:xliff translations/ --format=json
    

This work, including the code samples, is licensed under a Creative Commons BY-SA 3.0 license.

TOC

Version