Класс MessagesFileLoader
Общий фабричный пакет переводов, который загружает файлы переводов на основе расширения файла и имени пакета.
Этот класс является вызываемым, поэтому его можно использовать в качестве аргумента загрузчика пакетов.
Краткое описание свойств
-
$_extensionprotectedИмя расширения.string -
$_localeprotectedЯзык для загрузки для данного пакета.string -
$_nameprotectedИмя пакета (домена).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( )
Возвращает папки, в которых должен быть найден файл, в соответствии с языком и именем пакета.
Возвращает
массивСписок папок, в которых должен быть найден файл перевода
Подробное описание свойств
© 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