diff --git a/book/translation.rst b/book/translation.rst index 63a98e8309b..698bb7e203d 100644 --- a/book/translation.rst +++ b/book/translation.rst @@ -400,6 +400,15 @@ checks translation resources for several different locales: 3. If the translation still isn't found, Symfony uses the ``fallback`` configuration parameter, which defaults to ``en`` (see `Configuration`_). +.. versionadded:: 2.6 + The ability to log missing translations was introduced in Symfony 2.6. + +.. note:: + + When Symfony doesn't find a translation in the given locale, it will + add the missing translation to the log file. For details, + see :ref:`reference-framework-translator-logging`. + .. _book-translation-user-locale: Handling the User's Locale diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst index 9cfb5b6947b..700bc97a26d 100644 --- a/reference/configuration/framework.rst +++ b/reference/configuration/framework.rst @@ -48,6 +48,10 @@ Configuration * `profiler`_ * `collect`_ * :ref:`enabled ` +* `translator`_ + * :ref:`enabled ` + * `fallback`_ + * `logging`_ secret ~~~~~~ @@ -495,6 +499,42 @@ and activate the data collectors by hand:: $profiler->enable(); +translator +~~~~~~~~~~ + +.. _translator.enabled: + +enabled +....... + +**type**: ``boolean`` **default**: ``false`` + +Whether or not to enable the ``translator`` service in the service container. + +fallback +........ + +**default**: ``en`` + +This option is used when the translation key for the current locale wasn't found. + +For more details, see :doc:`/book/translation`. + +.. _reference-framework-translator-logging: + +logging +....... + +.. versionadded:: 2.6 + The ``logging`` option was introduced in Symfony 2.6. + +**default**: ``true`` when the debug mode is enabled, ``false`` otherwise. + +When ``true``, a log entry is made whenever the translator cannot find a translation +for a given key. The logs are made to the ``translation`` channel and at the ``debug`` +for level for keys where there is a translation in the fallback locale and the ``warning`` +level if there is no translation to use at all. + Full default Configuration -------------------------- @@ -612,6 +652,7 @@ Full default Configuration translator: enabled: false fallback: en + logging: "%kernel.debug%" # validation configuration validation: pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.

Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy