Переводчик
класс Переводчик реализует 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.7/Symfony/Component/Translation/Translator.html
