1. class
  2. Symfony
  3. \
  4. Component
  5. \
  6. Translation
  7. \
  8. Translator

Translator

class Translator implements TranslatorInterface, TranslatorInterface, TranslatorBagInterface

Properties

protected MessageCatalogueInterface[] $catalogues

Methods

__construct(string|null $locale, MessageFormatterInterface $formatter = null, string $cacheDir = null, bool $debug = false)

No description

setConfigCacheFactory(ConfigCacheFactoryInterface $configCacheFactory)

No description

addLoader(string $format, LoaderInterface $loader)

Adds a Loader.

addResource(string $format, mixed $resource, string $locale, string $domain = null)

Adds a Resource.

setLocale(string $locale)

Sets the current locale.

string
getLocale()

Returns the current locale.

setFallbackLocales(array $locales)

Sets the fallback locales.

array
getFallbackLocales()

Gets the fallback locales.

string
trans(string $id, array $parameters = array(), string|null $domain = null, string|null $locale = null)

Translates the given message.

string
transChoice(string $id, int $number, array $parameters = array(), string|null $domain = null, string|null $locale = null) deprecated

Translates the given choice message by choosing a translation according to a number.

MessageCatalogueInterface
getCatalogue(string|null $locale = null)

Gets the catalogue by locale.

array
getLoaders()

Gets the loaders.

loadCatalogue(string $locale)

No description

initializeCatalogue(string $locale)

No description

computeFallbackLocales($locale)

No description

assertValidLocale(string $locale)

Asserts that the locale is valid, throws an Exception if not.

Details

__construct(string|null $locale, MessageFormatterInterface $formatter = null, string $cacheDir = null, bool $debug = false)

Parameters

string|null $locale
MessageFormatterInterface $formatter
string $cacheDir
bool $debug

Exceptions

InvalidArgumentException If a locale contains invalid characters

setConfigCacheFactory(ConfigCacheFactoryInterface $configCacheFactory)

Parameters

ConfigCacheFactoryInterface $configCacheFactory

addLoader(string $format, LoaderInterface $loader)

Adds a Loader.

Parameters

string $format The name of the loader (see addResource())
LoaderInterface $loader A LoaderInterface instance

addResource(string $format, mixed $resource, string $locale, string $domain = null)

Adds a Resource.

Parameters

string $format The name of the loader (see addLoader())
mixed $resource The resource name
string $locale The locale
string $domain The domain

Exceptions

InvalidArgumentException If the locale contains invalid characters

setLocale(string $locale)

Sets the current locale.

Parameters

string $locale The locale

Exceptions

InvalidArgumentException If the locale contains invalid characters

string getLocale()

Returns the current locale.

Return Value

string The locale

setFallbackLocales(array $locales)

Sets the fallback locales.

Parameters

array $locales The fallback locales

Exceptions

InvalidArgumentException If a locale contains invalid characters

array getFallbackLocales()

Gets the fallback locales.

Return Value

array The fallback locales

string trans(string $id, array $parameters = array(), string|null $domain = null, string|null $locale = null)

Translates the given message.

Parameters

string $id The message id (may also be an object that can be cast to string)
array $parameters An array of parameters for the message
string|null $domain The domain for the message or null to use the default
string|null $locale The locale or null to use the default

Return Value

string The translated string

Exceptions

InvalidArgumentException If the locale contains invalid characters

string transChoice(string $id, int $number, array $parameters = array(), string|null $domain = null, string|null $locale = null) deprecated

deprecated since Symfony 4.2, use the trans() method instead with a %count% parameter

Translates the given choice message by choosing a translation according to a number.

Parameters

string $id The message id (may also be an object that can be cast to string)
int $number The number to use to find the index of the message
array $parameters An array of parameters for the message
string|null $domain The domain for the message or null to use the default
string|null $locale The locale or null to use the default

Return Value

string The translated string

Exceptions

InvalidArgumentException If the locale contains invalid characters

MessageCatalogueInterface getCatalogue(string|null $locale = null)

Gets the catalogue by locale.

Parameters

string|null $locale The locale or null to use the default

Return Value

MessageCatalogueInterface

Exceptions

InvalidArgumentException If the locale contains invalid characters

protected array getLoaders()

Gets the loaders.

Return Value

array LoaderInterface[]

protected loadCatalogue(string $locale)

Parameters

string $locale

protected initializeCatalogue(string $locale)

Parameters

string $locale

protected computeFallbackLocales($locale)

Parameters

$locale

protected assertValidLocale(string $locale)

Asserts that the locale is valid, throws an Exception if not.

Parameters

string $locale Locale to tests

Exceptions

InvalidArgumentException If the locale contains invalid characters