Класс I18n

Уничтожает все экземпляры переводчиков и создает новую пустую коллекцию переводов.

Возвращает

Регистрирует вызываемый объект, который можно использовать для создания новых экземпляров переводчиков для одного и того же домена переводов. Загрузчики будут вызываться всякий раз, когда запрашивается объект переводчика для домена, который еще не был настроен или загружен.

Регистрация загрузчиков полезна, когда вам нужно лениво использовать переводы в нескольких разных локалях для одного домена и вы не хотите использовать встроенную службу перевода на основе файлов gettext.

Объекты загрузчиков будут получать два аргумента: имя домена, который нужно создать, и запрашиваемую локаль. Эти объекты могут собирать сообщения из любого источника, но должны вернуть объект Cake\I18n\Package.

Пример:

use Cake\I18n\MessagesFileLoader;
 I18n::config('my_domain', function ($name, $locale) {
     // Load resources/locales/$locale/filename.po
     $fileLoader = new MessagesFileLoader('filename', $locale, 'po');
     return $fileLoader();
 });

Вы также можете собрать объект пакета самостоятельно:

use Cake\I18n\Package;
 I18n::config('my_domain', function ($name, $locale) {
     $package = new Package('default');
     $messages = (...); // Fetch messages for locale from external service.
     $package->setMessages($message);
     $package->setFallback('default');
     return $package;
 });

Параметры

Возвращает

Возвращает текущий настроенный по умолчанию форматер.

Возвращает

Возвращает локаль по умолчанию.

Это возвращает локаль по умолчанию до любых изменений, т.е. значение, как хранится в настройке PHP intl.default_locale до любого изменения этим классом.

Возвращает

Возвращает текущую локаль, сохраненную в настройке PHP intl.default_locale.

Возвращает

Возвращает экземпляр переводчика, который был настроен для указанного имени и локали.

Если локаль не передана, она берется из значения, возвращаемого методом getLocale().

Параметры

Возвращает

Исключения

Устанавливает имя форматера сообщений по умолчанию для будущих экземпляров переводчиков. По умолчанию доступны форматеры default и sprintf.

Параметры

Возвращает

Устанавливает локаль по умолчанию для будущих экземпляров переводчиков. Это также влияет на настройку PHP intl.default_locale.

Параметры

Возвращает

Устанавливает переводчика.

Настраивает будущих переводчиков, это достигается путем передачи вызываемого объекта в качестве последнего аргумента этой функции.

Пример:

I18n::setTranslator('default', function () {
     $package = new \Cake\I18n\Package();
     $package->setMessages([
         'Cake' => 'Gâteau'
     ]);
     return $package;
 }, 'fr_FR');

$translator = I18n::getTranslator('default', 'fr_FR');
 echo $translator->translate('Cake');

Вы также можете использовать класс Cake\I18n\MessagesFileLoader, чтобы загрузить определенный файл из папки. Например, для загрузки файла my_translations.po из папки resources/locales/custom, вы бы сделали следующее:

I18n::setTranslator(
 'default',
 new MessagesFileLoader('my_translations', 'custom', 'po'),
 'fr_FR'
);

Параметры

Возвращает

Возвращает экземпляр коллекции переводчиков. Его можно использовать для получения конкретных переводчиков на основе их имени и локали или для настройки некоторых аспектов будущих переводов, которые еще не созданы.

Возвращает

Устанавливает, используется ли обратный вызов домена.

Параметры

Возвращает