ConstraintViolationInterface
интерфейс ConstraintViolationInterface
Нарушение ограничения, произошедшее во время валидации.
Для каждого ограничения, которое не выполняется во время валидации, создается одно или несколько нарушений. Нарушения хранят сообщение о нарушении, путь к элементу, нарушающему валидацию, в графе валидации, и корневой элемент, который изначально был передан валидатору. Например, рассмотрим следующую графу:
(Person)---(firstName: string)
\
(address: Address)---(street: string)
Если объект Person валидируется и валидация терпит неудачу для свойства "firstName", сгенерированное нарушение имеет экземпляр Person в качестве корня и путь к свойству "firstName". Если валидация терпит неудачу для свойства "street" связанного экземпляра Address, корневой элемент по-прежнему является человеком, но путь к свойству - "address.street".
Методы
| string | getMessage() Возвращает сообщение о нарушении. | |
| string | getMessageTemplate() Возвращает исходное сообщение о нарушении. | |
| array | getMessageParameters() устарело Возвращает параметры, которые должны быть вставлены в исходное сообщение о нарушении. | |
| int|null | getMessagePluralization() устарело Возвращает число для множественного числа сообщения о нарушении. | |
| mixed | getRoot() Возвращает корневой элемент валидации. | |
| string | getPropertyPath() Возвращает путь к свойству от корневого элемента до нарушения. | |
| mixed | getInvalidValue() Возвращает значение, вызвавшее нарушение. | |
| string|null | getCode() Возвращает удобочитаемый код ошибки для нарушения. |
Подробности
string getMessage()
Возвращает сообщение о нарушении.
Результат
| string | Сообщение о нарушении |
string getMessageTemplate()
Возвращает исходное сообщение о нарушении.
Исходное сообщение о нарушении содержит заполнитель для параметров, возвращаемых {@link getMessageParameters}. Обычно вы передаете шаблон сообщения и параметры в движок перевода.
Результат
| string | Исходное сообщение о нарушении |
array getMessageParameters() устарело
устарело
Возвращает параметры, которые должны быть вставлены в исходное сообщение о нарушении.
Результат
| array | возможно пустой список параметров, индексируемых именами, которые появляются в шаблоне сообщения |
См. также
| getMessageTemplate() |
int|null getMessagePluralization() устарело
устарело
Возвращает число для множественного числа сообщения о нарушении.
Например, шаблон сообщения может иметь разные переводы на основе параметра "choices":
- Пожалуйста, выберите ровно одну запись. (choices=1)
- Пожалуйста, выберите две записи. (choices=2)
Этот метод возвращает значение параметра для выбора правильной формы множественного числа (в данном случае "choices").
Результат
| int|null | Число для использования при склонении сообщения |
mixed getRoot()
Возвращает корневой элемент валидации.
Результат
| mixed | Значение, которое было первоначально передано валидатору при запуске валидации. Поскольку валидатор просматривает граф объектов, значение, в котором возникает нарушение, не обязательно является значением, которое изначально было валидировано. |
string getPropertyPath()
Возвращает путь к свойству от корневого элемента до нарушения.
Результат
| string | Путь к свойству указывает, как валидатор достиг недействительного значения от корневого элемента. Если корневой элемент - экземпляр Person со свойством "address", содержащим экземпляр Address с недействительным свойством "street", сгенерированный путь к свойству - "address.street". Доступ к свойству обозначается точками, а доступ к массиву - квадратными скобками, например "addresses[1].street". |
mixed getInvalidValue()
Возвращает значение, вызвавшее нарушение.
Результат
| mixed | недействительное значение, которое привело к тому, что валидированное ограничение не выполнилось |
string|null getCode()
Возвращает удобочитаемый код ошибки для нарушения.
Результат
| string|null | Код ошибки |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/2.8/Symfony/Component/Validator/ConstraintViolationInterface.html
