EventNameTranslator
extends AbstractTranslator
in package
Base class of route translators: keeps the list of route factories that use a translator.
Table of Contents
Properties
- $EventManager : EventManager
- $idToNameCache : array<int, array<int, string>>
- $localeResolver : LocaleResolver
- $nameToIdCache : array<int, array<string, int>>
- $warmedUp : bool
Methods
- __construct() : mixed
- addTargetFactory() : void
- Registers a route factory that uses this translator.
- clearCache() : void
- Clears the cache.
- getTargetFactories() : array<string|int, string>
- Returns the route factories that use this translator.
- idToName() : string|null
- nameToId() : int|null
- warmupCache() : void
- Loads all Events with their translations in a single query.
- warmupFromEntities() : void
- Fills the cache from already loaded entities (no DB query).\n *
- fromCacheWithLanguageFallback() : TValue|null
- Returns a value from a translation cache, falling back to the other languages.
Properties
$EventManager read-only
private
EventManager
$EventManager
$idToNameCache
private
array<int, array<int, string>>
$idToNameCache
= []
Cache id->name [languageId][EventId] = name
$localeResolver read-only
private
LocaleResolver
$localeResolver
$nameToIdCache
private
array<int, array<string, int>>
$nameToIdCache
= []
Cache name->id [languageId][name] = EventId
$warmedUp
private
bool
$warmedUp
= false
whether the cache has been filled
Methods
__construct()
public
__construct(EventManager $EventManager, LocaleResolver $localeResolver) : mixed
Parameters
- $EventManager : EventManager
- $localeResolver : LocaleResolver
addTargetFactory()
Registers a route factory that uses this translator.
public
addTargetFactory(string $factoryClass) : void
Called from the factory constructor as addTargetFactory($this::class).
Parameters
- $factoryClass : string
-
fully qualified factory class name
clearCache()
Clears the cache.
public
clearCache() : void
getTargetFactories()
Returns the route factories that use this translator.
public
getTargetFactories() : array<string|int, string>
Return values
array<string|int, string> —factory class names without namespace
idToName()
public
idToName(int $id, string $loc) : string|null
Parameters
- $id : int
- $loc : string
Return values
string|nullnameToId()
public
nameToId(string $name, string $loc) : int|null
Parameters
- $name : string
- $loc : string
Return values
int|nullwarmupCache()
Loads all Events with their translations in a single query.
public
warmupCache([array<string|int, int>|null $EventIds = null ]) : void
Parameters
- $EventIds : array<string|int, int>|null = null
-
when null, loads all Events; otherwise only the given ones
warmupFromEntities()
Fills the cache from already loaded entities (no DB query).\n *
public
warmupFromEntities(array<string|int, mixed> $Events) : void
Parameters
- $Events : array<string|int, mixed>
-
Evententities with loaded translations
fromCacheWithLanguageFallback()
Returns a value from a translation cache, falling back to the other languages.
protected
fromCacheWithLanguageFallback(array<string|int, mixed> $cache, int $languageId, TKey $key) : TValue|null
IMPORTANT: without the fallback a translator returns null when the translation for the
language is missing, and the route cannot build the URL at all ("No route for ..."). One
untranslated category then breaks the whole foreign-language page, not just its own link.
Untranslated content shows in the main language instead of disappearing: the URL carries
the main-language slug under /en/, until someone adds the translation.
Parameters
- $cache : array<string|int, mixed>
- $languageId : int
- $key : TKey