Merge branch '5.4' into 6.0

* 5.4:
  Added some references
  Describe validation callables

Author: javiereguiluz

components/console/helpers/questionhelper.rst

@@ -344,6 +344,8 @@ method::
     of the validator. If the answer is invalid, don't throw exceptions in the
     normalizer and let the validator handle those errors.
 
+.. _console-validate-question-answer:
+
 Validating the Answer
 ---------------------
 
@@ -388,6 +390,22 @@ If you reach this max number it will use the default value. Using ``null`` means
 the amount of attempts is infinite. The user will be asked as long as they provide an
 invalid answer and will only be able to proceed if their input is valid.
 
+.. tip::
+
+    You can even use the :doc:`Validator </validation>` component to
+    validate the input by using the :method:`Symfony\\Component\\Validator\\Validation::createCallable`
+    method::
+
+        use Symfony\Component\Validator\Constraints\Regex;
+        use Symfony\Component\Validator\Validation;
+
+        $question = new Question('Please enter the name of the bundle', 'AcmeDemoBundle');
+        $validation = Validation::createCallable(new Regex([
+            'pattern' => '/^[a-zA-Z]+Bundle$',
+            'message' => 'The name of the bundle should be suffixed with \'Bundle\'',
+        ]));
+        $question->setValidator($validation);
+
 Validating a Hidden Response
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

components/options_resolver.rst

@@ -335,6 +335,8 @@ is thrown::
 In sub-classes, you can use :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::addAllowedTypes`
 to add additional allowed types without erasing the ones already set.
 
+.. _optionsresolver-validate-value:
+
 Value Validation
 ~~~~~~~~~~~~~~~~
 
@@ -376,6 +378,21 @@ returns ``true`` for acceptable values and ``false`` for invalid values::
         // return true or false
     });
 
+.. tip::
+
+    You can even use the :doc:`Validator </validation>` component to validate the
+    input by using the :method:`Symfony\\Component\\Validator\\Validation::createValidCallable`
+    method::
+
+        use Symfony\Component\OptionsResolver\OptionsResolver;
+        use Symfony\Component\Validator\Constraints\Length;
+        use Symfony\Component\Validator\Validation;
+
+        // ...
+        $resolver->setAllowedValues('transport', Validation::createValidCallable(
+            new Length(['min' => 10 ])
+        ));
+
 In sub-classes, you can use :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::addAllowedValues`
 to add additional allowed values without erasing the ones already set.
 

validation.rst

@@ -230,6 +230,31 @@ Inside the template, you can output the list of errors exactly as needed:
     Each validation error (called a "constraint violation"), is represented by
     a :class:`Symfony\\Component\\Validator\\ConstraintViolation` object.
 
+.. index::
+   single: Validation; Callables
+
+Validation Callables
+~~~~~~~~~~~~~~~~~~~~
+
+The ``Validation`` also allows you to create a closure to validate values
+against a set of constraints (useful for example when
+:ref:`validating Console command answers <console-validate-question-answer>` or
+when :ref:`validating OptionsResolver values <optionsresolver-validate-value>`):
+
+:method:`Symfony\\Component\\Validator\\Validation::createCallable`
+    This returns a closure that throws ``ValidationFailedException`` when the
+    constraints aren't matched.
+:method:`Symfony\\Component\\Validator\\Validation::createValidCallable`
+    This returns a closure that returns ``false`` when the constraints aren't matched.
+
+.. versionadded:: 5.1
+
+    ``Validation::createCallable()`` was introduced in Symfony 5.1.
+
+.. versionadded:: 5.3
+
+    ``Validation::createValidCallable()`` was introduced in Symfony 5.3.
+
 .. index::
    single: Validation; Constraints