Skip to content


Subversion checkout URL

You can clone with
Download ZIP
133 lines (96 sloc) 5.226 kb


Add the bunde to your composer.json file:

require: {
    // ...
    "lexik/translation-bundle": "~2.0"

Then run a composer update:

composer.phar update
# OR
composer.phar update lexik/translation-bundle # to only update the bundle

Register the bundle with your kernel:

// in AppKernel::registerBundles()
$bundles = array(
    // ...
    new Lexik\Bundle\TranslationBundle\LexikTranslationBundle(),
    // ...

Then install the required assets:

./app/console assets:install


Minimum configuration:

# app/config/config.yml
    fallback_locale: en      # (required) default locale to use
    managed_locales: [en]    # (required) locales that the bundle have to manage

Additional configuration options (default values are shown here):

# app/config/config.yml
    base_layout:     "LexikTranslationBundle::layout.html.twig" # layout used with the translation edition template
    use_yml_tree:    false    # if "true" we will print a nice tree in the yml source files. It is a little slower.
    grid_input_type: text     # define field type used in the grid (text|textarea)
    grid_toggle_similar: false  # if "true", on the grid if a locale colunm is shown/hidden then similar locales columns will be shown/hidden too.
                                    # so if the col "en" is shown/hidden all "en_XX" cols will be shown/hidden too. Not in the reverse order ("en_XX" clicked, no impact on "en")
        type: orm                    # where to store translations: "orm", "mongodb" or "propel"
        object_manager: something    # The name of the entity / document manager which uses different connection (see:
                                     # When using propel, this can be used to specify the propel connection name
        type:                 all     # resources type to register: "all", "files" or "database"
        managed_locales_only: true    # will only load resources for managed locales
    auto_cache_clean: false     # set to true to make the bundle automatically clear translations cache files

Note that MongoDB 2.0.0 or later is required if you choose to use MongoDB to store translations.

If you use Doctrine ORM, you have to update your database:

./app/console doctrine:schema:update --force

To use the translation edition page, add the routing file to you application:

# app/config/routing.yml
    resource: "@LexikTranslationBundle/Resources/config/routing.yml"
    prefix:   /my-prefix

The translations edition page will be available here: /my-prefix/grid

Note: The grid will be empty until you import translations in database. If the grid does not appear, please check your base template has a block named javascript_footer.

Import translations

To import translations files content into your database just run the following command:

./app/console lexik:translations:import [bundleName] [--cache-clear] [--force] [--globals]

This command will import all application and bundles translations files according to the managed_locales defined in configuration (it will also load tanslations from SF conponents).

Command arguments:

  • bundleName: only import translations for the given bundle name.

Command options:

  • --cache-clear (or -c): remove translations cache files (it won't clear all cache files but just files from app/cache/[env]/translations/).
  • --force (or -f): update the translations even if the element already exist in the database.
  • --globals (or -g): import only from the app/Resources/translations. It will ignore the option if you provide a BundleName to import.
  • --locales (or -l): import only for these locales, instead of using the managed locales from the config. eg: --locales=fr --locales=en
  • --domains (or -d): Only export files for given domains (comma separated). eg --domains=messages,validators
  • --case-insensitive (or -i): Convert keys as lower case to check if a key has already been imported.

Export translations

To export translations from the database in to files run the following command:

./app/console lexik:translations:export [--locales=en,de] [--domains=messages,validators] [--format=yml] [--case-insensitive]

This command will export all translations from the database in to files. A translation is exported in the same file (and format) it was imported in, except for vendors files which are exported in app/Resources/translations/ and in this case the command will only export translations that changed.

Command options:

  • --locales: Only export files for given locales.
  • --domains: Only export files for given domains.
  • --format: Force the output format.

Note that it's not required to export translations to make them appear on your website as the DatabaseLoader will load them.


Read the documentation for testing

Jump to Line
Something went wrong with that request. Please try again.