Класс TranslatorRegistry
Создаёт и хранит экземпляры переводчиков, доступные по имени и локали.
- Aura\Intl\TranslatorLocator
-
Cake\I18n\TranslatorRegistry
Краткое описание свойств
-
$_cacherprotectedОбъект CacheEngine, используемый для запоминания переводчика между запросами.
-
$_defaultFormatterprotectedstringИмя форматера по умолчанию для недавно созданных переводчиков из загрузчика по умолчанию.
-
$_fallbackLoaderprotectedИмя загрузчика по умолчаниюstring -
$_loadersprotectedcallable[]Список функций загрузчика, индексированных по имени домена. Загрузчики — вызываемые объекты, которые используются по умолчанию для построения пакетов переводов, когда для комбинации имени переводчика и локали не найдены.
-
$_useFallbackprotectedИспользовать домен по умолчанию для загрузчиков переводов.boolean
Краткое описание методов
- __construct() publicКонструктор.
- _fallbackLoader() protected
Возвращает новый экземпляр переводчика для данного имени и локали на основе конвенций.
- _getFromLoader() protected
Регистрирует новый пакет, передавая функцию регистрируемого загрузчика для имени пакета.
- _getTranslator() protectedПолучает переводчик из реестра по имени пакета для локали.
- _partialLoader() protectedВозвращает функцию, которая может использоваться в качестве загрузчика для registerLoaderMethod
- defaultFormatter() public
Устанавливает имя форматера сообщений по умолчанию для будущих экземпляров переводчика.
- get() publicПолучает переводчик из реестра по имени пакета для локали.
- registerLoader() public
Регистрирует функцию загрузчика для имени пакета, которая будет использоваться в качестве резервного варианта, если пакет с таким именем не найден.
- setCacher() public
Устанавливает экземпляр CacheEngine, используемый для запоминания переводчиков между запросами.
- setLoaderFallback() publicУстанавливает домен по умолчанию для загрузчика.
- useFallback() publicУстанавливает, используется ли домен по умолчанию.
Подробное описание методов
__construct()source public
__construct( Aura\Intl\PackageLocator $packages , Aura\Intl\FormatterLocator $formatters , Cake\I18n\TranslatorFactory $factory , string $locale )
Конструктор.
Параметры
- Aura\Intl\PackageLocator
$packages - Загрузчик пакетов.
- Aura\Intl\FormatterLocator
$formatters - Загрузчик форматеров.
- Cake\I18n\TranslatorFactory
$factory Фабрика переводчиков для создания объектов переводчиков для локали и пакета.
- string
$locale - Код локали по умолчанию.
_fallbackLoader()source protected
_fallbackLoader( string $name , string $locale )
Возвращает новый экземпляр переводчика для данного имени и локали на основе конвенций.
Параметры
- string
$name - Имя пакета перевода.
- string
$locale - Локаль для создания переводчика.
Возвращает
Aura\Intl\Translator_getFromLoader()source protected
_getFromLoader( string $name , string $locale )
Регистрирует новый пакет, передавая функцию регистрируемого загрузчика для имени пакета.
Параметры
- string
$name - Имя пакета переводчика
- string
$locale - Локаль, для которой должен быть построен пакет
Возвращает
Aura\Intl\TranslatorInterfaceОбъект переводчика.
_getTranslator()source protected
_getTranslator( string $name , string|null $locale )
Получает переводчик из реестра по имени пакета для локали.
Параметры
- string
$name - Пакет переводчика для получения.
- string|null
$locale Локаль для использования; если пусто, используется локаль по умолчанию.
Возвращает
Aura\Intl\TranslatorInterfaceОбъект переводчика.
_partialLoader()source protected
_partialLoader( )
Возвращает функцию, которая может использоваться в качестве загрузчика для registerLoaderMethod
Возвращает
callabledefaultFormatter()source public
defaultFormatter( string|null $name null )
Устанавливает имя форматера сообщений по умолчанию для будущих экземпляров переводчика.
Если вызывается без аргументов, возвращает текущее значение конфигурации.
Параметры
- string|null
$nameoptional null - Имя форматера для использования.
Возвращает
stringИмя форматера.
get()source public
get( string $name , string|null $locale null )
Получает переводчик из реестра по имени пакета для локали.
Параметры
- string
$name - Пакет переводчика для получения.
- string|null
$localeoptional null Локаль для использования; если пусто, используется локаль по умолчанию.
Возвращает
Aura\Intl\TranslatorInterface|nullОбъект переводчика.
Исключения
Aura\Intl\ExceptionЕсли переводчик с таким именем не был найден для заданной локали.
registerLoader()source public
registerLoader( string $name , callable $loader )
Регистрирует функцию загрузчика для имени пакета, которая будет использоваться в качестве резервного варианта, если пакет с таким именем не найден.
Обратные вызовы загрузчика будут получать в качестве первого аргумента имя пакета, а в качестве второго — локаль.
Параметры
- string
$name - Имя пакета переводчика для регистрации загрузчика
- callable
$loader - Вызываемый объект, который должен возвращать пакет
setCacher()source public
setCacher( Cake\Cache\CacheEngine $cacher )
Устанавливает экземпляр CacheEngine, используемый для запоминания переводчиков между запросами.
Параметры
-
Cake\Cache\CacheEngine$cacher - Экземпляр кэшера.
setLoaderFallback()source public
setLoaderFallback( string $name , callable $loader )
Устанавливает домен по умолчанию для загрузчика.
Параметры
- string
$name - Имя домена загрузчика
- callable
$loader - Вызываемый загрузчик
Возвращает
callableзагрузчик
useFallback()source public
useFallback( boolean $enable true )
Устанавливает, используется ли обратный сброс по умолчанию для домена.
Параметры
- boolean
$enableнеобязательно true - флаг для включения или отключения обратного сброса
Подробное описание свойств
$_cachersource
protected Cake\Cache\CacheEngine
Объект CacheEngine, используемый для запоминания переводчика между запросами.
$_defaultFormattersource
protected string
Название форматера по умолчанию, используемого для вновь созданных переводчиков из загрузчика обратного сброса.
'default'
$_loaderssource
protected callable[]
Список функций загрузки, индексированных по имени домена. Загрузчики — вызываемые объекты, которые вызываются по умолчанию для создания пакетов переводов, когда ни один из них не найден для сочетания имени переводчика и языка.
[]
$_useFallbacksource
protected boolean
Использовать домен обратного сброса для загрузчиков переводов.
true
© 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.TranslatorRegistry.html