MessageCatalogue
class MessageCatalogue implements MessageCatalogueInterface, MetadataAwareInterface
MessageCatalogue.
Methods
| __construct(string $locale, array $messages = array()) Конструктор. | ||
| string | getLocale() Получение языка каталога. | |
| array | getDomains() Получение доменных имен. | |
| array | all(string $domain = null) Получение сообщений в заданном домене. | |
| set(string $id, string $translation, string $domain = 'messages') Установка перевода сообщения. | ||
| bool | has(string $id, string $domain = 'messages') Проверка наличия перевода сообщения. | |
| bool | defines(string $id, string $domain = 'messages') Проверка наличия перевода сообщения (не учитывается механизм падения). | |
| string | get(string $id, string $domain = 'messages') Получение перевода сообщения. | |
| replace(array $messages, string $domain = 'messages') Установка переводов для заданного домена. | ||
| add(array $messages, string $domain = 'messages') Добавление переводов для заданного домена. | ||
| addCatalogue(MessageCatalogueInterface $catalogue) Объединение переводов из данного каталога с текущим. | ||
| addFallbackCatalogue(MessageCatalogueInterface $catalogue) Объединение переводов из данного каталога с текущим только при отсутствии перевода. | ||
| MessageCatalogueInterface|null | getFallbackCatalogue() Получение каталога падения. | |
| ResourceInterface[] | getResources() Возвращает массив загруженных ресурсов для построения этого набора. | |
| addResource(ResourceInterface $resource) Добавляет ресурс для этого набора. | ||
| mixed | getMetadata(string $key = '', string $domain = 'messages') Получение метаданных для заданного домена и ключа. | |
| setMetadata(string $key, mixed $value, string $domain = 'messages') Добавление метаданных в домен сообщений. | ||
| deleteMetadata(string $key = '', string $domain = 'messages') Удаление метаданных для заданного ключа и домена. |
Details
__construct(string $locale, array $messages = array())
Конструктор.
Параметры
| string | $locale | Локаль |
| array | $messages | Массив сообщений, классифицированных по домену |
string getLocale()
Получает локаль каталога.
Значение возврата
| string | Локаль |
array getDomains()
Получает домены.
Значение возврата
| array | Массив доменов |
array all(string $domain = null)
Получает сообщения в заданном домене.
Если $domain равен null, возвращает все сообщения.
Параметры
| string | $domain | Имя домена |
Значение возврата
| array | Массив сообщений |
set(string $id, string $translation, string $domain = 'messages')
Устанавливает перевод сообщения.
Параметры
| string | $id | Идентификатор сообщения |
| string | $translation | Перевод сообщения |
| string | $domain | Имя домена |
bool has(string $id, string $domain = 'messages')
Проверяет, существует ли перевод для сообщения.
Параметры
| string | $id | Идентификатор сообщения |
| string | $domain | Имя домена |
Значение возврата
| bool | true, если перевод существует, иначе false |
bool defines(string $id, string $domain = 'messages')
Проверяет, существует ли перевод для сообщения (не учитывает механизм обратной совместимости).
Параметры
| string | $id | Идентификатор сообщения |
| string | $domain | Имя домена |
Значение возврата
| bool | true, если перевод существует, иначе false |
string get(string $id, string $domain = 'messages')
Получает перевод сообщения.
Параметры
| string | $id | Идентификатор сообщения |
| string | $domain | Имя домена |
Значение возврата
| string | Перевод сообщения |
replace(array $messages, string $domain = 'messages')
Заменяет переводы для данного домена.
Параметры
| array | $messages | Массив переводов |
| string | $domain | Имя домена |
add(array $messages, string $domain = 'messages')
Добавляет переводы для данного домена.
Параметры
| array | $messages | Массив переводов |
| string | $domain | Имя домена |
addCatalogue(MessageCatalogueInterface $catalogue)
Объединяет переводы из данного каталога с текущим.
Два каталога должны иметь одинаковую локаль.
Параметры
| MessageCatalogueInterface | $catalogue | Экземпляр MessageCatalogueInterface |
addFallbackCatalogue(MessageCatalogueInterface $catalogue)
Объединяет переводы из данного каталога с текущим только в случае отсутствия перевода.
Используется для предоставления перевода по умолчанию, когда перевода для текущей локали не существует.
Параметры
| MessageCatalogueInterface | $catalogue | Экземпляр MessageCatalogueInterface |
MessageCatalogueInterface|null getFallbackCatalogue()
Получает каталог обратной совместимости.
Значение возврата
| MessageCatalogueInterface|null | Экземпляр MessageCatalogueInterface или null, если обратная совместимость не задана |
ResourceInterface[] getResources()
Возвращает массив загруженных ресурсов для построения этого набора.
Значение возврата
| ResourceInterface[] | Массив ресурсов |
addResource(ResourceInterface $resource)
Добавляет ресурс для этого набора.
Параметры
| ResourceInterface | $resource | Экземпляр ресурса |
mixed getMetadata(string $key = '', string $domain = 'messages')
Получает метаданные для заданного домена и ключа.
Передача пустого домена вернет массив со всеми метаданными, индексированными по домену, а затем по ключу. Передача пустого ключа вернет массив со всеми метаданными для данного домена.
Параметры
| string | $key | Ключ |
| string | $domain | Имя домена |
Значение возврата
| mixed | Установленное значение или массив с доменами/ключами или null |
setMetadata(string $key, mixed $value, string $domain = 'messages')
Добавляет метаданные в домен сообщений.
Параметры
| string | $key | Ключ |
| mixed | $value | Значение |
| string | $domain | Имя домена |
deleteMetadata(string $key = '', string $domain = 'messages')
Удаляет метаданные для данного ключа и домена.
Передача пустого домена удалит все метаданные. Передача пустого ключа удалит все метаданные для данного домена.
Параметры
| string | $key | Ключ |
| string | $domain | Имя домена |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.0/Symfony/Component/Translation/MessageCatalogue.html
