minor symfony#7805 [Validator] Added array validation example to raw values (CoolGoose, javiereguiluz, wouterj)

xabbuh · xabbuh · commit abfd38e01fbc · 2017-07-21T15:52:47.000+02:00
This PR was merged into the 2.7 branch. Discussion ---------- [Validator] Added array validation example to raw values This example was removed from the component's README and it has some value imo. Finishes symfony#7161 Commits ------- 06f67b4 Moved array validation to the Raw values sub-guide 64f5ad9 Fixed some syntax issues c8b6b45 missing constraint example from the old readme
diff --git a/components/validator.rst b/components/validator.rst
@@ -46,6 +46,8 @@ characters long::
         }
     }
 
+The validator returns the list of violations.
+
 Retrieving a Validator Instance
 -------------------------------
 
diff --git a/validation/raw_values.rst b/validation/raw_values.rst
@@ -46,12 +46,34 @@ looks like this::
         // ...
     }
 
-By calling ``validate`` on the validator, you can pass in a raw value and
+By calling ``validate()`` on the validator, you can pass in a raw value and
 the constraint object that you want to validate that value against. A full
 list of the available constraints - as well as the full class name for each
 constraint - is available in the :doc:`constraints reference </reference/constraints>`
 section.
 
+Validation of arrays is possible using the ``Collection`` constraint::
+
+    use Symfony\Component\Validator\Validation;
+    use Symfony\Component\Validator\Constraints as Assert;
+
+    $validator = Validation::createValidator();
+
+    $constraint = new Assert\Collection(array(
+        // the keys correspond to the keys in the input array
+        'name' => new Assert\Collection(array(
+          'first_name' => new Assert\Length(array('min' => 101)),
+          'last_name' => new Assert\Length(array('min' => 1)),
+        )),
+        'email' => new Assert\Email(),
+        'simple' => new Assert\Length(array('min' => 102)),
+        'gender' => new Assert\Choice(array(3, 4)),
+        'file' => new Assert\File(),
+        'password' => new Assert\Length(array('min' => 60)),
+    ));
+
+    $violations = $validator->validateValue($input, $constraint);
+
 The ``validate()`` method returns a :class:`Symfony\\Component\\Validator\\ConstraintViolationList`
 object, which acts just like an array of errors. Each error in the collection
 is a :class:`Symfony\\Component\\Validator\\ConstraintViolation` object,

Original file line number	Diff line number	Diff line change
`@@ -46,6 +46,8 @@ characters long::`
`46`	`46`	`}`
`47`	`47`	`}`
`48`	`48`
	`49`	`+The validator returns the list of violations.`
	`50`	`+`
`49`	`51`	`Retrieving a Validator Instance`
`50`	`52`	`-------------------------------`
`51`	`53`