RegionNameTranslator
extends AbstractTranslator
in package
Base class of route translators: keeps the list of route factories that use a translator.
Table of Contents
Properties
- $idToNameCache : array<int, array<int, string>>
- $loadedIds : array<int, true>
- $localeResolver : LocaleResolver
- $missedNames : array<int, array<string, true>>
- $nameToIdCache : array<int, array<string, int>>
- $regionManager : RegionManager
- $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 regions 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
$idToNameCache
private
array<int, array<int, string>>
$idToNameCache
= []
Cache id->name [languageId][regionId] = name
$loadedIds
private
array<int, true>
$loadedIds
= []
ids of regions already loaded by a targeted query (all translations at once)
$localeResolver read-only
private
LocaleResolver
$localeResolver
$missedNames
private
array<int, array<string, true>>
$missedNames
= []
slugs unknown to the DB in this request [languageId][slug]
$nameToIdCache
private
array<int, array<string, int>>
$nameToIdCache
= []
Cache name->id [languageId][name] = regionId
$regionManager read-only
private
RegionManager
$regionManager
$warmedUp
private
bool
$warmedUp
= false
whether the cache has been filled
Methods
__construct()
public
__construct(RegionManager $regionManager, LocaleResolver $localeResolver) : mixed
Parameters
- $regionManager : RegionManager
- $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 regions with their translations in a single query.
public
warmupCache([array<string|int, int>|null $regionIds = null ]) : void
Parameters
- $regionIds : array<string|int, int>|null = null
-
when null, loads all regions; otherwise only the given ones
warmupFromEntities()
Fills the cache from already loaded entities (no DB query).\n *
public
warmupFromEntities(array<string|int, mixed> $categories) : void
Parameters
- $categories : array<string|int, mixed>
-
Regionentities 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