MessageCatalogue
class MessageCatalogue implements MessageCatalogueInterface, MetadataAwareInterface
Методы
| __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') Проверяет, есть ли перевод для сообщения (не учитывая механизм fallback). | |
| 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() Получает каталог fallback. | |
| 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') Удаляет метаданные для заданного ключа и домена. |
Детали
__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 |
addFallbackCatalogue(MessageCatalogueInterface $catalogue)
Объединяет переводы из данного каталога с текущим только в случае отсутствия перевода.
Используется для предоставления значений по умолчанию, когда перевода для текущей локали нет.
Параметры
| MessageCatalogueInterface | $catalogue |
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/2.8/Symfony/Component/Translation/MessageCatalogue.html
