Конфігурація

Конструктор класу Translator вимагає одного аргументу: локалі:

1
2
3
4

use Symfony\Component\Translation\Translator;
use Symfony\Component\Translation\MessageSelector;

$translator = new Translator('fr_FR');

Завантаження каталогів повідомлень

Повідомлення зберігаються у каталогах повідомлень всередині класу Translator. Каталог повідомлень є чимось на зразок словника перекладів для конкретної локалі.

Компонент Translation використовує класи Завантажувача для завантаження каталогів. Ви можете завантажувати кілька джерел для однієї локалі, які потім можна комбінувати в один каталог.

Компонент постачається з деякими Завантажувачами за замовчуванням і ви можете також створювати ваш власний Завантажувач. Завантажувачі за замовчуванням:

• ArrayLoader - для завантаження каталогів з PHP масивів.
• CsvFileLoader - для завантаження каталогів з CSV файлів.
• IcuDatFileLoader - для завантаження каталогів з пакетів джерел.
• IcuResFileLoader - для завантаження каталогів з пакетів джерел.
• IniFileLoader - для завантаження каталогів з ini файлів.
• MoFileLoader - для завантаження каталогів з gettext файлів.
• PhpFileLoader - для завантаження каталогів з PHP файлів.
• PoFileLoader - для завантаження каталогів з gettext файлів.
• QtFileLoader - для завантаження каталогів з QT XML файлів.
• XliffFileLoader - для завантаження каталогів з Xliff файлів.
• JsonFileLoader - для завантаження каталогів з JSON файлів.
• YamlFileLoader - для зазавантаженнягрузки каталогів з Yaml файлів (вимагає компонент Yaml).

Всі завантажувачі файлів вимагають компонент Config.

Ви можете також створити ваш власний завантажувач, у разі, якщо формат ще не підтримується жодним із завантажувачів за замовчуванням.

Спочатку, вам потрібно додати один або більше завантажувачів в Translator:

1
2

// ...
$translator->addLoader('array', new ArrayLoader());

Перший аргумент - це ім'я, на яке може посилатися завантажувач у перекладачі, а другий аргумент - екземпляр самого завантажувача. Після цього, ви можете додавати ваші джерела, використовуючи правильний завантажувач.

1
2
3
4

// ...
$translator->addResource('array', array(
    'Hello World!' => 'Bonjour',
), 'fr_FR');

1
2
3

// ...
$translator->addLoader('yaml', new YamlFileLoader());
$translator->addResource('yaml', 'path/to/messages.fr.yaml', 'fr_FR');

Резеврні локалі

Якщо повідомлення немає в каталозі певної локалі, перекладач буде шукати в одному або декількох каталогах резервних локалей. Наприклад, уявіть, що ви намагаєтеся перекласти на локаль fr_FR:

1. Спочатку перекладач шукає переклад у локалі fr_FR;
2. Якщо його не було знайдено, перекладач шукає переклад у локалі fr;
3. Якщо його все одно не було знайдено, перекладач використовує одну або кілька резервних локалей, ясно встановлених у перекладачеві.

Для (3), резервні локалі можна встановити, викликавши setFallbackLocales():

1
2

// ...
$translator->setFallbackLocales(array('en'));