From d670ab8bd9839ed545b7896790cb29ab64333892 Mon Sep 17 00:00:00 2001 From: Tristan Roussel Date: Sat, 5 Dec 2015 02:33:58 +0100 Subject: [PATCH] Document constraint validator alias optional --- cookbook/validation/custom_constraint.rst | 15 ++++----------- 1 file changed, 4 insertions(+), 11 deletions(-) diff --git a/cookbook/validation/custom_constraint.rst b/cookbook/validation/custom_constraint.rst index a248a8494aa..43ec8127081 100644 --- a/cookbook/validation/custom_constraint.rst +++ b/cookbook/validation/custom_constraint.rst @@ -167,7 +167,7 @@ Constraint Validators with Dependencies If your constraint validator has dependencies, such as a database connection, it will need to be configured as a service in the Dependency Injection Container. This service must include the ``validator.constraint_validator`` -tag and an ``alias`` attribute: +tag and may include an ``alias`` attribute: .. configuration-block:: @@ -195,21 +195,14 @@ tag and an ``alias`` attribute: ->register('validator.unique.your_validator_name', 'Fully\Qualified\Validator\Class\Name') ->addTag('validator.constraint_validator', array('alias' => 'alias_name')); -Your constraint class should now use this alias to reference the appropriate -validator:: +As mentioned above, Symfony will automatically look for a class named after +the constraint, with ``Validator`` appended. You can override this in your constraint class:: public function validatedBy() { - return 'alias_name'; + return 'Fully\Qualified\Class\Named\ConstraintValidator'; // or 'alias_name' if provided } -As mentioned above, Symfony will automatically look for a class named after -the constraint, with ``Validator`` appended. If your constraint validator -is defined as a service, it's important that you override the -``validatedBy()`` method to return the alias used when defining your service, -otherwise Symfony won't use the constraint validator service, and will -instantiate the class instead, without any dependencies injected. - Class Constraint Validator ~~~~~~~~~~~~~~~~~~~~~~~~~~