saxulum/saxulum-translation-provider

Saxulum Translation Provider (yaml)

saxulum-translation-provider

works with plain silex-php, _(*1)

, _(*2)

Features

• Register translations

Requirements

• php >=5.3
• Symfony Config Component >=2.3
• Symfony Finder Component >=2.3
• Symfony Translation Component >=2.3
• Symfony Yaml Component >=2.3

Installation

Through Composer as [saxulum/saxulum-translation-provider][1]., _(*3)

Preparation (for non silex users)

Debug value is needed

```{.php} $container['debug'] = true; // or false, <sub>(*4)</sub>

##### Define translator service

```{.php}
use Symfony\Component\Translation\Translator;

$container['translator'] = function () {
    return new Translator('en');
};

Or if you load silex/silex as a dependency you can also use the TranslationServiceProvider., <sub>(*5)</sub>

```{.php} use Silex\Provider\TranslationServiceProvider;, <sub>(*6)</sub>

$container['locale'] = 'en'; $container->register(new TranslationServiceProvider());, <sub>(*7)</sub>

#### For all users

##### With translation cache (faster)

```{.php}
use Saxulum\Translation\Silex\Provider\TranslationProvider;

$container->register(new TranslationProvider(), array(
    'translation_cache' => '/path/to/cache'
));

• debug == true: the cache file will be build at each load
• debug == false: the cache file will be build if not exists, delete it if its out of sync

Without translation cache (slower)

```{.php} use Saxulum\Translation\Silex\Provider\TranslationProvider;, <sub>(*8)</sub>

$container->register(new TranslationProvider());, <sub>(*9)</sub>

Usage
-----

#### Add the translation paths

```{.php}
$container['translation_paths'] = $container->extend('translation_paths', function ($paths) {
    $paths[] = '/path/to/the/translations';

    return $paths;
});

Usage with Twig templates

To get access to the |trans filter in Twig templates, you must register the translator first and then add the TwigServiceProvider from silex/silex. You will also have to require the symfony/twig-bridge package., <sub>(*10)</sub>

```{.php} use Silex\Provider\TwigServiceProvider;, <sub>(*11)</sub>

$this->register(new TwigServiceProvider(), [ 'twig.path' => array(DIR.'/../views'), 'twig.options' => array('cache' => $cacheDir), ]); ```, <sub>(*12)</sub>