Класс 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'
);

Параметры

Возвращает

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

Возвращает

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

Параметры

Возвращает