DefaultTranslator устаревшее
class DefaultTranslator implements TranslatorInterface
устаревшее
Простая реализация переводчика, которая просто заменяет параметры в идентификаторах сообщений.
Пример использования:
$translator = new DefaultTranslator();
echo $translator->trans(
'This is a {{ var }}.',
array('{{ var }}' => 'donkey')
);
// -> This is a donkey.
echo $translator->transChoice(
'This is {{ count }} donkey.|These are {{ count }} donkeys.',
3,
array('{{ count }}' => 'three')
);
// -> These are three donkeys.
Этот переводчик не поддерживает каталоги сообщений, домены перевода или языковые локали. Вместо этого он реализует подмножество возможностей {@link \Symfony\Component\Translation\Translator} и может использоваться в местах, где перевод по умолчанию не требуется, но должен быть опциональным.
Методы
| 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) Интерполирует заданное сообщение выбора, выбирая вариант в соответствии с числом. | |
| setLocale(string $locale) Не поддерживается. | ||
| string | getLocale() Возвращает локаль переводчика. |
Подробности
string trans(string $id, array $parameters = array(), string|null $domain = null, string|null $locale = null)
Интерполирует заданное сообщение.
Параметры заменяются в сообщении таким же образом, как использует {@link strtr()}.
Пример использования:
$translator = new DefaultTranslator();
echo $translator->trans(
'This is a {{ var }}.',
array('{{ var }}' => 'donkey')
);
// -> This is a donkey.
Параметры
| string | $id | Идентификатор сообщения (также может быть объектом, который можно преобразовать в строку) |
| array | $parameters | Массив параметров для сообщения |
| string|null | $domain | Домен для сообщения или null для использования по умолчанию |
| string|null | $locale | Локаль или null для использования по умолчанию |
Возвращаемое значение
| string | Переведённая строка |
string transChoice(string $id, int $number, array $parameters = array(), string|null $domain = null, string|null $locale = null)
Интерполирует заданное сообщение выбора, выбирая вариант в соответствии с числом.
Варианты передаются в идентификаторе сообщения в формате «<единственное число>|<множественное число>». «<единственное число>» выбирается, если переданное $number равно ровно 1. В противном случае выбирается «<множественное число>».
Этот формат согласуется с форматом, поддерживаемым {@link \Symfony\Component\Translation\Translator}, но не обладает такой же выразительностью. Хотя Translator поддерживает интервалы в переводах сообщений, которые необходимы для языков, отличных от английского, этот переводчик этого не делает. Для этого или аналогичных функций вы должны использовать Translator или пользовательскую реализацию {@link \Symfony\Component\Translation\TranslatorInterface}.
Пример использования:
echo $translator->transChoice(
'This is {{ count }} donkey.|These are {{ count }} donkeys.',
0,
array('{{ count }}' => 0)
);
// -> These are 0 donkeys.
echo $translator->transChoice(
'This is {{ count }} donkey.|These are {{ count }} donkeys.',
1,
array('{{ count }}' => 1)
);
// -> This is 1 donkey.
echo $translator->transChoice(
'This is {{ count }} donkey.|These are {{ count }} donkeys.',
3,
array('{{ count }}' => 3)
);
// -> These are 3 donkeys.
Параметры
| string | $id | Идентификатор сообщения (также может быть объектом, который можно преобразовать в строку) |
| int | $number | Число, используемое для поиска индекса сообщения |
| array | $parameters | Массив параметров для сообщения |
| string|null | $domain | Домен для сообщения или null для использования по умолчанию |
| string|null | $locale | Локаль или null для использования по умолчанию |
Возвращаемое значение
| string | Переведённая строка |
Исключения
| InvalidArgumentException | Если идентификатор сообщения не имеет формат «единственное число|множественное число». |
setLocale(string $locale)
Не поддерживается.
Параметры
| string | $locale | Локаль |
Исключения
| BadMethodCallException |
string getLocale()
Возвращает локаль переводчика.
Возвращаемое значение
| string | Локаль |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.0/Symfony/Component/Validator/DefaultTranslator.html