minor symfony#10758 [Validator] Added new UnexpectedValueException (TimoBakx)

javiereguiluz · javiereguiluz · commit 7cf2d3a2b0f9 · 2018-12-17T16:37:30.000+01:00
This PR was merged into the 4.2 branch. Discussion ---------- [Validator] Added new UnexpectedValueException Fixes symfony#10551. Commits ------- 643afc8 Added new UnexpectedValueException
diff --git a/validation/custom_constraint.rst b/validation/custom_constraint.rst
@@ -76,7 +76,11 @@ The validator class is also simple, and only has one required method ``validate(
             }
 
             if (!is_string($value)) {
-                throw new UnexpectedTypeException($value, 'string');
+                // throw this exception if your validator cannot handle the passed type so that it can be marked as invalid
+                throw new UnexpectedValueException($value, 'string');
+
+                // separate multiple types using pipes
+                // throw new UnexpectedValueException($value, 'string|int');
             }
 
             if (!preg_match('/^[a-zA-Z0-9]+$/', $value, $matches)) {
@@ -94,6 +98,9 @@ message as its argument and returns an instance of
 :class:`Symfony\\Component\\Validator\\Violation\\ConstraintViolationBuilderInterface`.
 The ``addViolation()`` method call finally adds the violation to the context.
 
+.. versionadded:: 4.2
+    The ``UnexpectedValueException`` was introduced in Symfony 4.2.
+
 Using the new Validator
 -----------------------
 
