ConstraintViolationInterface (Component\Validator)
Symfony\Component\Validator\ConstraintViolationInterface
interface ConstraintViolationInterface
A violation of a constraint that happened during validation.
For each constraint that fails during validation one or more violations are created. The violations store the violation message, the path to the failing element in the validation graph and the root element that was originally passed to the validator. For example, take the following graph:
(Person)---(firstName: string) \ (address: Address)---(street: string)
If the Person object is validated and validation fails for the "firstName" property, the generated violation has the Person instance as root and the property path "firstName". If validation fails for the "street" property of the related Address instance, the root element is still the person, but the property path is "address.street".
Methods
string | getMessage() Returns the violation message. | |
string | getMessageTemplate() Returns the raw violation message. | |
array | getParameters() Returns the parameters to be inserted into the raw violation message. | |
int|null | getPlural() Returns a number for pluralizing the violation message. | |
mixed | getRoot() Returns the root element of the validation. | |
string | getPropertyPath() Returns the property path from the root element to the violation. | |
mixed | getInvalidValue() Returns the value that caused the violation. | |
string|null | getCode() Returns a machine-digestible error code for the violation. |
Details
public string getMessage()
Returns the violation message.
public string getMessageTemplate()
Returns the raw violation message.
The raw violation message contains placeholders for the parameters returned by {@link getParameters}. Typically you'll pass the message template and parameters to a translation engine.
public array getParameters()
Returns the parameters to be inserted into the raw violation message.
public int|null getPlural()
Returns a number for pluralizing the violation message.
For example, the message template could have different translation based on a parameter "choices":
- Please select exactly one entry. (choices=1)
- Please select two entries. (choices=2)
This method returns the value of the parameter for choosing the right pluralization form (in this case "choices").
public mixed getRoot()
Returns the root element of the validation.
public string getPropertyPath()
Returns the property path from the root element to the violation.
public mixed getInvalidValue()
Returns the value that caused the violation.
public string|null getCode()
Returns a machine-digestible error code for the violation.
© 2004–2016 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.0/Symfony/Component/Validator/ConstraintViolationInterface.html