Переводчик
класс Переводчик расширяет Переводчик и реализует Интерфейс для подогрева кэша
Переводчик.
Методы
| __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) устарело
устарело
Устанавливает язык по умолчанию.
Параметры
| string|array | $locales | Язык по умолчанию |
Исключения
| InvalidArgumentException | Если язык содержит недопустимые символы |
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 | Если язык содержит недопустимые символы |
array[array] getMessages(string|null $locale = null)
Собирает все сообщения для заданного языка.
Параметры
| 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/2.7/Symfony/Bundle/FrameworkBundle/Translation/Translator.html
