Spec-Zone.ru › CakePHP 3.4

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

Параметры

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

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

string $extension необязательно 'po'

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

__invoke()source public

__invoke( )

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

Возвращает

Aura\Intl\Package|false

Выбрасывает

RuntimeException

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


translationsFolders()source public

translationsFolders( )

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

Возвращает

array
Список папок, в которых следует искать файл перевода

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

$_extensionsource

protected string

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

$_localesource

protected string

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

$_namesource

protected string

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

© 2005–2017 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.4/class-Cake.I18n.MessagesFileLoader.html

Spec-Zone.ru

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