Переводчик
класс Translator реализует TranslatorInterface, TranslatorBagInterface
Методы
| __construct(строка $locale, MessageSelector $selector = null, строка|null $cacheDir = null, bool $debug = false) | ||
| setConfigCacheFactory(ConfigCacheFactoryInterface $configCacheFactory) | ||
| addLoader(строка $format, LoaderInterface $loader) Добавляет загрузчик. | ||
| addResource(строка $format, смешанный $resource, строка $locale, строка $domain = null) Добавляет ресурс. | ||
| setLocale(строка $locale) Устанавливает текущий язык. | ||
| строка | getLocale() Возвращает текущий язык. | |
| setFallbackLocale(строка|массив $locales) устарело Устанавливает язык по умолчанию. | ||
| setFallbackLocales(массив $locales) Устанавливает языки по умолчанию. | ||
| массив | getFallbackLocales() Получает языки по умолчанию. | |
| строка | trans(строка $id, массив $parameters = массив(), строка|null $domain = null, строка|null $locale = null) Переводит заданное сообщение. | |
| строка | transChoice(строка $id, целое число $number, массив $parameters = массив(), строка|null $domain = null, строка|null $locale = null) Переводит заданное сообщение выбора, выбирая перевод в соответствии с числом. | |
| MessageCatalogueInterface | getCatalogue(строка|null $locale = null) Получает каталог по языку. | |
| массив[массив] | getMessages(строка|null $locale = null) устарело Собирает все сообщения для данного языка. | |
| dumpCatalogue($locale, ConfigCacheInterface $cache) Этот метод является общедоступным, так как он должен вызываться из замыкания в PHP 5.3. Он должен быть защищённым (или даже закрытым, если это возможно) в 3.0. |
Подробности
__construct(string $locale, MessageSelector $selector = null, string|null $cacheDir = null, bool $debug = false)
Параметры
| string | $locale | Локализация |
| MessageSelector | $selector | Выбор сообщения для множественного числа |
| string|null | $cacheDir | Директория для кеша |
| bool | $debug | Использовать кеш в режиме отладки? |
Исключения
| 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 | Локализация |
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 |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/2.8/Symfony/Component/Translation/Translator.html
