Переводчик
класс Переводчик расширяет Переводчик и реализует Интерфейс подготовки к кэшированию
Переводчик.
Свойства
| protected Интерфейс каталога сообщений[] | $catalogues | из Переводчик | |
| protected | $container | ||
| protected | $loaderIds | ||
| protected | $options |
Методы
| __construct(ContainerInterface $container, Интерфейс форматировщика сообщений $formatter, string $defaultLocale, array $loaderIds = array(), array $options = array()) Конструктор. | ||
| setConfigCacheFactory(Интерфейс фабрики кэша конфигурации $configCacheFactory) | из Переводчик | |
| addLoader(string $format, Интерфейс загрузчика $loader) Добавляет загрузчик. | из Переводчик | |
| addResource(string $format, mixed $resource, string $locale, string $domain = null) Добавляет ресурс. | ||
| setLocale(string $locale) Устанавливает текущий язык. | из Переводчик | |
| string | getLocale() Возвращает текущий язык. | из Переводчик |
| setFallbackLocales(array $locales) Устанавливает языки по умолчанию. | из Переводчик | |
| array | getFallbackLocales() Получает языки по умолчанию. | из Переводчик |
| string | trans(string $id, array $parameters = array(), string|null $domain = null, string|null $locale = null) Переводит заданное сообщение. | из Переводчик |
| string | transChoice(string $id, int $number, array $parameters = array(), string|null $domain = null, string|null $locale = null) Переводит заданное выборочное сообщение, выбирая перевод в соответствии с числом. | из Переводчик |
| Интерфейс каталога сообщений | getCatalogue(string|null $locale = null) Получает каталог по языку. | из Переводчик |
| array | getLoaders() Получает загрузчики. | из Переводчик |
| loadCatalogue(string $locale) | из Переводчик | |
| initializeCatalogue(string $locale) | ||
| computeFallbackLocales($locale) | из Переводчик | |
| assertValidLocale(string $locale) Проверяет, что язык допустим, выбрасывает исключение, если нет. | из Переводчик | |
| warmUp(string $cacheDir) Загружает кэш. | ||
| initialize() |
Подробности
__construct(ContainerInterface $container, MessageFormatterInterface $formatter, string $defaultLocale, array $loaderIds = array(), array $options = array())
Конструктор.
Доступные параметры:
- cache_dir: Каталог кэша (или null для отключения кэширования)
- debug: Включить отладку (по умолчанию false)
- resource_files: Список доступных ресурсов перевода, сгруппированных по языку.
Параметры
| ContainerInterface | $container | Экземпляр ContainerInterface |
| MessageFormatterInterface | $formatter | |
| string | $defaultLocale | |
| array | $loaderIds | Массив идентификаторов загрузчиков |
| array | $options | Массив параметров |
Исключения
| InvalidArgumentException |
setConfigCacheFactory(ConfigCacheFactoryInterface $configCacheFactory)
Параметры
| ConfigCacheFactoryInterface | $configCacheFactory |
addLoader(string $format, LoaderInterface $loader)
Добавляет загрузчик.
Параметры
| string | $format | Имя загрузчика (см. addResource()) |
| LoaderInterface | $loader | Экземпляр LoaderInterface |
addResource(string $format, mixed $resource, string $locale, string $domain = null)
Добавляет ресурс.
Параметры
| string | $format | Имя загрузчика (см. addLoader()) |
| mixed | $resource | Имя ресурса |
| string | $locale | Язык |
| string | $domain | Домен |
Исключения
| InvalidArgumentException | Если язык содержит недопустимые символы |
setLocale(string $locale)
Устанавливает текущий язык.
Параметры
| string | $locale | Язык |
Исключения
| InvalidArgumentException | Если язык содержит недопустимые символы |
string getLocale()
Возвращает текущий язык.
Значение возврата
| string | Язык |
setFallbackLocales(array $locales)
Устанавливает языки по умолчанию.
Параметры
| array | $locales | Языки по умолчанию |
Исключения
| InvalidArgumentException | Если язык содержит недопустимые символы |
array getFallbackLocales()
Получает языки по умолчанию.
Значение возврата
| array | $locales Языки по умолчанию |
string trans(string $id, array $parameters = array(), string|null $domain = null, string|null $locale = null)
Переводит данное сообщение.
Параметры
| string | $id | Идентификатор сообщения (также может быть объектом, который можно привести к строке) |
| array | $parameters | Массив параметров для сообщения |
| string|null | $domain | Домен сообщения или null для использования по умолчанию |
| string|null | $locale | Язык или null для использования по умолчанию |
Значение возврата
| string | Переведённая строка |
Исключения
| InvalidArgumentException | Если язык содержит недопустимые символы |
string transChoice(string $id, int $number, array $parameters = array(), string|null $domain = null, string|null $locale = null)
Переводит данное сообщение выбора, выбирая перевод в соответствии с числом.
Параметры
| string | $id | Идентификатор сообщения (также может быть объектом, который можно привести к строке) |
| int | $number | Число для поиска индекса сообщения |
| array | $parameters | Массив параметров для сообщения |
| string|null | $domain | Домен сообщения или null для использования по умолчанию |
| string|null | $locale | Язык или null для использования по умолчанию |
Значение возврата
| string | Переведённая строка |
Исключения
| InvalidArgumentException | Если язык содержит недопустимые символы |
MessageCatalogueInterface getCatalogue(string|null $locale = null)
Получает каталог по языку.
Параметры
| string|null | $locale | Язык или null для использования по умолчанию |
Значение возврата
| MessageCatalogueInterface |
Исключения
| InvalidArgumentException | Если язык содержит недопустимые символы |
protected array getLoaders()
Получает загрузчики.
Значение возврата
| array | LoaderInterface[] |
protected loadCatalogue(string $locale)
Параметры
| string | $locale |
protected initializeCatalogue(string $locale)
Параметры
| string | $locale |
protected computeFallbackLocales($locale)
Параметры
| $locale |
protected assertValidLocale(string $locale)
Проверяет, что язык допустим. Выбрасывает исключение, если нет.
Параметры
| string | $locale | Язык для проверки |
Исключения
| InvalidArgumentException | Если язык содержит недопустимые символы |
warmUp(string $cacheDir)
Подготавливает кэш.
Параметры
| string | $cacheDir | Каталог кэша |
protected initialize()
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
https://api.symfony.com/4.1/Symfony/Bundle/FrameworkBundle/Translation/Translator.html