Переводчик
класс Переводчик расширяет Переводчик и реализует Интерфейс подготовки к кэшированию
Переводчик.
Методы
| __construct(Интерфейс контейнера $container, Выборщик сообщений $selector, array $loaderIds = array(), array $options = array()) Конструктор. | ||
| setConfigCacheFactory(Интерфейс фабрики кэша конфигурации $configCacheFactory) Устанавливает фабрику ConfigCache для использования. | из Переводчика | |
| addLoader(string $format, Интерфейс загрузчика $loader) Добавляет загрузчик. | из Переводчика | |
| addResource(string $format, mixed $resource, string $locale, string $domain = null) Добавляет ресурс. | из Переводчика | |
| setLocale(string $locale) Устанавливает текущий язык. | из Переводчика | |
| string | getLocale() Возвращает текущий язык. | из Переводчика |
| setFallbackLocale(string|array $locales) устаревший Устанавливает язык по умолчанию. | из Переводчика | |
| 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[array] | getMessages(string|null $locale = null) устаревший Собрать все сообщения для данного языка. | из Переводчика |
| dumpCatalogue($locale, Интерфейс кэша конфигурации $cache) Этот метод является публичным, потому что его нужно можно вызывать из замыкания в PHP 5.3. В версии 3.0 его следует сделать защищённым (или даже приватным, если это возможно). | из Переводчика | |
| warmUp(string $cacheDir) Подготавливает кэш. |
Подробности
__construct(ContainerInterface $container, MessageSelector $selector, array $loaderIds = array(), array $options = array())
Конструктор.
Доступные параметры:
- cache_dir: Директория кэша (или null для отключения кэширования)
- debug: Включить отладку (по умолчанию false)
- resource_files: Список доступных ресурсов переводов, сгруппированных по локали.
Параметры
| ContainerInterface | $container | Экземпляр ContainerInterface |
| MessageSelector | $selector | Селектор сообщений для множественного числа |
| array | $loaderIds | Массив идентификаторов лоадеров |
| array | $options | Массив параметров |
Исключения
| InvalidArgumentException |
setConfigCacheFactory(ConfigCacheFactoryInterface $configCacheFactory)
Устанавливает фабрику ConfigCache для использования.
Параметры
| 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 | Локаль |
setFallbackLocale(string|array $locales) deprecated
deprecated
Устанавливает локаль по умолчанию.
Параметры
| string|array | $locales | Локаль(и) по умолчанию |
Исключения
| InvalidArgumentException | Если локаль содержит недопустимые символы |
setFallbackLocales(array $locales)
Устанавливает fallback-локали.
Параметры
| array | $locales | Fallback-локали |
Исключения
| InvalidArgumentException | Если локаль содержит недопустимые символы |
array getFallbackLocales()
Получает fallback-локали.
Значение результата
| array | $locales Fallback-локали |
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 | Если локаль содержит недопустимые символы |
array[array] getMessages(string|null $locale = null) deprecated
deprecated
Собирает все сообщения для данной локали.
Параметры
| string|null | $locale | Локаль переводов, по умолчанию текущая локаль |
Значение результата
| array[array] | индексирован по каталогу |
dumpCatalogue($locale, ConfigCacheInterface $cache)
Этот метод является публичным, потому что он должен быть вызываем из лямбда-выражения в PHP 5.3. Он должен быть защищённым (или даже закрытым, если это возможно) в версии 3.0.
Параметры
| $locale | ||
| ConfigCacheInterface | $cache |
warmUp(string $cacheDir)
Подготавливает кэш.
Параметры
| string | $cacheDir | Директория кэша |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.1/Symfony/Bundle/FrameworkBundle/Translation/Translator.html