НарушениеОграничения
класс НарушениеОграничения реализует ConstraintViolationInterface
Стандартная реализация {@ConstraintViolationInterface}.
Методы
| __construct(string $message, string $messageTemplate, array $parameters, mixed $root, string $propertyPath, mixed $invalidValue, int|null $plural = null, mixed $code = null, Constraint $constraint = null, mixed $cause = null) Создаёт новое нарушение ограничения. | ||
| string | __toString() Преобразует нарушение в строку для отладки. | |
| string | getMessageTemplate() Возвращает исходное сообщение о нарушении. | |
| array | getMessageParameters() устарело Возвращает параметры, которые будут подставлены в исходное сообщение о нарушении. | |
| getParameters() Псевдоним для {@link getMessageParameters()}. | ||
| int|null | getMessagePluralization() устарело Возвращает число для множественного числа в сообщении о нарушении. | |
| getPlural() Псевдоним для {@link getMessagePluralization()}. | ||
| string | getMessage() Возвращает сообщение о нарушении. | |
| mixed | getRoot() Возвращает корневой элемент валидации. | |
| string | getPropertyPath() Возвращает путь к свойству от корневого элемента до нарушения. | |
| mixed | getInvalidValue() Возвращает значение, вызвавшее нарушение. | |
| Constraint|null | getConstraint() Возвращает ограничение, валидация которого привела к нарушению. | |
| mixed | getCause() Возвращает причину нарушения. | |
| mixed | getCode() Возвращает удобочитаемый код ошибки нарушения. |
Подробности
__construct(string $message, string $messageTemplate, array $parameters, mixed $root, string $propertyPath, mixed $invalidValue, int|null $plural = null, mixed $code = null, Constraint $constraint = null, mixed $cause = null)
Создаёт новое нарушение ограничения.
Параметры
| string | $message | Сообщение о нарушении |
| string | $messageTemplate | Исходное сообщение о нарушении |
| array | $parameters | Параметры для подстановки в исходное сообщение о нарушении |
| mixed | $root | Значение, первоначально переданное валидатору |
| string | $propertyPath | Путь к свойству от корневого значения до невалидного значения |
| mixed | $invalidValue | Невалидное значение, вызвавшее это нарушение |
| int|null | $plural | Число для определения формы множественного числа при переводе сообщения |
| mixed | $code | Код ошибки нарушения |
| Constraint | $constraint | Ограничение, валидация которого привела к нарушению |
| mixed | $cause | Причина нарушения |
string __toString()
Преобразует нарушение в строку для отладки.
Возвращаемое значение
| string | Нарушение в виде строки |
string getMessageTemplate()
Возвращает исходное сообщение о нарушении.
Исходное сообщение о нарушении содержит заполнитель для параметров, возвращённых {@link getMessageParameters}. Обычно вы передаёте шаблон сообщения и параметры в механизм перевода.
Возвращаемое значение
| string | Исходное сообщение о нарушении |
array getMessageParameters() устарело
устарело
Возвращает параметры, которые нужно подставить в исходное сообщение о нарушении.
Возвращаемое значение
| array | возможно пустой список параметров, индексированных по именам, которые появляются в шаблоне сообщения |
getParameters()
Псевдоним для {@link getMessageParameters()}.
int|null getMessagePluralization() устарело
устарело
Возвращает число для множественного числа в сообщении о нарушении.
Например, шаблон сообщения может иметь разные переводы в зависимости от параметра "choices":
- Пожалуйста, выберите ровно одну запись. (choices=1)
- Пожалуйста, выберите две записи. (choices=2)
Этот метод возвращает значение параметра для выбора правильной формы множественного числа (в этом случае "choices").
Возвращаемое значение
| int|null | Число, используемое для множественного числа в сообщении |
getPlural()
Псевдоним для {@link getMessagePluralization()}.
string getMessage()
Возвращает сообщение о нарушении.
Возвращаемое значение
| string | Сообщение о нарушении |
mixed getRoot()
Возвращает корневой элемент валидации.
Возвращаемое значение
| mixed | Значение, которое было первоначально передано валидатору при запуске валидации. Поскольку валидатор проходит по объектной графе, значение, в котором возникает нарушение, не обязательно является значением, которое изначально было валидировано. |
string getPropertyPath()
Возвращает путь к свойству от корневого элемента до нарушения.
Возвращаемое значение
| string | Путь к свойству показывает, как валидатор достиг невалидного значения от корневого элемента. Если корневой элемент — экземпляр Person со свойством "address", которое содержит экземпляр Address с невалидным свойством "street", сгенерированный путь к свойству — "address.street". Доступ к свойству обозначается точками, а доступ к массиву обозначается квадратными скобками, например "addresses[1].street". |
mixed getInvalidValue()
Возвращает значение, вызвавшее нарушение.
Возвращаемое значение
| mixed | невалидное значение, которое вызвало ошибку валидации ограничений |
Constraint|null getConstraint()
Возвращает ограничение, валидация которого привела к нарушению.
Возвращаемое значение
| Constraint|null | Ограничение или null, если оно неизвестно |
mixed getCause()
Возвращает причину нарушения.
Возвращаемое значение
| mixed |
mixed getCode()
Возвращает удобочитаемый код ошибки нарушения.
Возвращаемое значение
| mixed | Код ошибки |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/2.7/Symfony/Component/Validator/ConstraintViolation.html