Spec-Zone.ru › CakePHP 3.8

Класс MessagesFileLoader

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

Этот класс является вызываемым, поэтому его можно использовать в качестве аргумента загрузчика пакетов.

Пространство имён: Cake\I18n
Расположение: I18n/MessagesFileLoader.php

Краткое описание свойств

  • $_extension protected
    string
    Имя расширения.
  • $_locale protected
    string
    Язык для загрузки для данного пакета.
  • $_name protected
    string
    Имя пакета (домена).

Краткое описание методов

  • __construct() public

    Создаёт загрузчик файла перевода. Файл, который будет загружен, соответствует следующим правилам:

  • __invoke() public

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

  • translationsFolders() public

    Возвращает папки, в которых должен быть найден файл, в соответствии с языком и именем пакета.

Подробное описание методов

__construct()source public

__construct( string $name , string $locale , string $extension = 'po' )

Создаёт загрузчик файла перевода. Файл, который будет загружен, соответствует следующим правилам:

  • Язык — это папка в директории Locale, будет использоваться резервный вариант, если папка не найдена.
  • Значение $name соответствует имени загружаемого файла.
  • Если загружен плагин с нижнее подчеркиванием версии $name, файл перевода будет загружен из этого плагина.

Примеры:

Загрузить и разобрать src/Locale/fr/validation.po

$loader = new MessagesFileLoader('validation', 'fr_FR', 'po');
$package = $loader();

Загрузить и разобрать src/Locale/fr_FR/validation.mo

$loader = new MessagesFileLoader('validation', 'fr_FR', 'mo');
$package = $loader();

Загрузить файл plugins/MyPlugin/src/Locale/fr/my_plugin.po:

$loader = new MessagesFileLoader('my_plugin', 'fr_FR', 'mo');
$package = $loader();

Параметры

строка $name
Имя (домен) пакета переводов.
строка $locale

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

строка $extension необязательный 'po'

Расширение файла, которое нужно использовать. Оно также будет сопоставлено с классом анализатора сообщений.

__invoke()source public

__invoke( )

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

Возвращает

Aura\Intl\Package|false

Исключения

RuntimeException

если не удалось найти класс анализатора файла для указанного расширения файла.


translationsFolders()source public

translationsFolders( )

Возвращает папки, в которых должен быть найден файл, в соответствии с языком и именем пакета.

Возвращает

массив
Список папок, в которых должен быть найден файл перевода

Подробное описание свойств

$_extensionsource

protected строка

Имя расширения.

$_localesource

protected строка

Язык для загрузки для данного пакета.

$_namesource

protected строка

Имя пакета (домена).

© 2005–present The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/3.8/class-Cake.I18n.MessagesFileLoader.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API