Class TranslatorRegistry
Constructs and stores instances of translators that can be retrieved by name and locale.
Property Summary
-
$_cacher protected
Cake\Cache\CacheEngineA CacheEngine object that is used to remember translator across requests.
-
$_defaultFormatter protected
stringThe name of the default formatter to use for newly created translators from the fallback loader
-
$_loaders protected
arrayA list of loader functions indexed by domain name. Loaders are callables that are invoked as a default for building translation packages where none can be found for the combination of translator name and locale.
-
$_useFallback protected
boolUse fallback-domain for translation loaders.
Method Summary
-
_fallbackLoader() protected
Returns a new translator instance for the given name and locale based of conventions.
-
_getFromLoader() protected
Registers a new package by passing the register loaded function for the package name.
-
_getTranslator() protected
Gets a translator from the registry by package for a locale.
-
_partialLoader() protected
Returns a function that can be used as a loader for the registerLoaderMethod
-
defaultFormatter() public
Sets the name of the default messages formatter to use for future translator instances.
-
get() public
Gets a translator from the registry by package for a locale.
-
registerLoader() public
Registers a loader function for a package name that will be used as a fallback in case no package with that name can be found.
-
setCacher() public
Sets the CacheEngine instance used to remember translators across requests.
-
setLoaderFallback() public
Set domain fallback for loader.
-
useFallback() public
Set if the default domain fallback is used.
Method Detail
_fallbackLoader() ¶ protected
_fallbackLoader(string $name, string $locale): Aura\Intl\TranslatorReturns a new translator instance for the given name and locale based of conventions.
Parameters
-
string$name The translation package name.
-
string$locale The locale to create the translator for.
Returns
Aura\Intl\Translator_getFromLoader() ¶ protected
_getFromLoader(string $name, string $locale): Aura\Intl\TranslatorInterfaceRegisters a new package by passing the register loaded function for the package name.
Parameters
-
string$name The name of the translator package
-
string$locale The locale that should be built the package for
Returns
Aura\Intl\TranslatorInterface_getTranslator() ¶ protected
_getTranslator(string $name, string|null $locale): Aura\Intl\TranslatorInterfaceGets a translator from the registry by package for a locale.
Parameters
-
string$name The translator package to retrieve.
-
string|null$locale The locale to use; if empty, uses the default locale.
Returns
Aura\Intl\TranslatorInterface_partialLoader() ¶ protected
_partialLoader(): callableReturns a function that can be used as a loader for the registerLoaderMethod
Returns
callabledefaultFormatter() ¶ public
defaultFormatter(string|null $name = null): stringSets the name of the default messages formatter to use for future translator instances.
If called with no arguments, it will return the currently configured value.
Parameters
-
string|null$name optional The name of the formatter to use.
Returns
stringget() ¶ public
get(string $name, string|null $locale = null): Aura\Intl\TranslatorInterfaceGets a translator from the registry by package for a locale.
Parameters
-
string$name The translator package to retrieve.
-
string|null$locale optional The locale to use; if empty, uses the default locale.
Returns
Aura\Intl\TranslatorInterfaceThrows
Aura\Intl\ExceptionIf no translator with that name could be found for the given locale.
registerLoader() ¶ public
registerLoader(string $name, callable $loader): voidRegisters a loader function for a package name that will be used as a fallback in case no package with that name can be found.
Loader callbacks will get as first argument the package name and the locale as the second argument.
Parameters
-
string$name The name of the translator package to register a loader for
-
callable$loader A callable object that should return a Package
Returns
voidsetCacher() ¶ public
setCacher(Cake\Cache\CacheEngine $cacher): voidSets the CacheEngine instance used to remember translators across requests.
Parameters
-
Cake\Cache\CacheEngine$cacher The cacher instance.
Returns
voidsetLoaderFallback() ¶ public
setLoaderFallback(string $name, callable $loader): callableSet domain fallback for loader.
Parameters
-
string$name The name of the loader domain
-
callable$loader invokable loader
Returns
callableuseFallback() ¶ public
useFallback(bool $enable = true): voidSet if the default domain fallback is used.
Parameters
-
bool$enable optional flag to enable or disable fallback
Returns
voidProperty Detail
$_cacher ¶ protected
A CacheEngine object that is used to remember translator across requests.
Type
Cake\Cache\CacheEngine$_defaultFormatter ¶ protected
The name of the default formatter to use for newly created translators from the fallback loader
Type
string$_loaders ¶ protected
A list of loader functions indexed by domain name. Loaders are callables that are invoked as a default for building translation packages where none can be found for the combination of translator name and locale.
Type
array