/symfony-bundle

Symfony integration for Translations

Primary LanguagePHP

Translation Bundle

Latest Version Build Status Code Coverage Quality Score SensioLabsInsight Total Downloads Coding Style

Symfony integration for PHP Translation

Install

Install this bundle via Composer:

$ composer require php-translation/symfony-bundle

If you're using Symfony Flex - you're done! Symfony Flex will create default configuration for you, change it if needed. If you don't use Symfony Flex, you will need to do a few more simple steps.

  1. First, register the bundle:
# config/bundles.php
return [
    // ...
    Translation\Bundle\TranslationBundle::class => ['all' => true],
];
  1. Then, configure the bundle. An example configuration looks like this:
# config/packages/php_translation.yaml
translation:
    locales: ["en"]
    edit_in_place:
        enabled: false
        config_name: app
    configs:
        app:
            dirs: ["%kernel.project_dir%/templates", "%kernel.project_dir%/src"]
            output_dir: "%kernel.project_dir%/translations"
            excluded_names: ["*TestCase.php", "*Test.php"]
            excluded_dirs: [cache, data, logs]
# config/packages/dev/php_translation.yaml
translation:
    symfony_profiler:
        enabled: true
    webui:
        enabled: true
  1. And the last step, add new routes:
# config/routes/dev/php_translation.yaml
_translation_webui:
    resource: "@TranslationBundle/Resources/config/routing_webui.yml"
    prefix:  /admin
  
_translation_profiler:
    resource: '@TranslationBundle/Resources/config/routing_symfony_profiler.yml'
# config/routes/php_translation.yaml
_translation_edit_in_place:
    resource: '@TranslationBundle/Resources/config/routing_edit_in_place.yml'
    prefix:  /admin

Documentation

Read the full documentation at http://php-translation.readthedocs.io.