From 0c048dda247e24b47d5bac363e1f99bfa6500d45 Mon Sep 17 00:00:00 2001 From: Abdellatif Ait boudad Date: Wed, 23 Jul 2014 20:34:48 +0000 Subject: [PATCH] added logging to translator. --- book/translation.rst | 9 ++++++ reference/configuration/framework.rst | 41 +++++++++++++++++++++++++++ 2 files changed, 50 insertions(+) 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: