Spec-Zone.ru › CakePHP 3.5

Класс 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–2018 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.5/class-Cake.I18n.MessagesFileLoader.html

Spec-Zone.ru

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