[Validator] Document the "normalizer" option

Author: renan-taranto

reference/constraints/Email.rst

@@ -11,6 +11,7 @@ Options     - `checkHost`_
             - `groups`_
             - `message`_
             - `mode`_
+            - `normalizer`_
             - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Email`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\EmailValidator`
@@ -167,6 +168,7 @@ html5
 
 This matches the pattern used for the `HTML5 email input element`_.
 
+.. include:: /reference/constraints/_normalizer-option.rst.inc
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 .. _egulias/email-validator: https://packagist.org/packages/egulias/email-validator

reference/constraints/Ip.rst

@@ -9,6 +9,7 @@ IPv6 and many other combinations.
 Applies to  :ref:`property or method <validation-property-target>`
 Options     - `groups`_
             - `message`_
+            - `normalizer`_
             - `payload`_
             - `version`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Ip`
@@ -96,6 +97,7 @@ Parameter        Description
 ``{{ value }}``  The current (invalid) value
 ===============  ==============================================================
 
+.. include:: /reference/constraints/_normalizer-option.rst.inc
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 version

reference/constraints/Length.rst

@@ -19,6 +19,7 @@ Options     - `charset`_
             - `maxMessage`_
             - `min`_
             - `minMessage`_
+            - `normalizer`_
             - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Length`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\LengthValidator`
@@ -213,4 +214,5 @@ Parameter          Description
 ``{{ value }}``    The current (invalid) value
 =================  ============================================================
 
+.. include:: /reference/constraints/_normalizer-option.rst.inc
 .. include:: /reference/constraints/_payload-option.rst.inc

reference/constraints/NotBlank.rst

@@ -11,6 +11,7 @@ Applies to  :ref:`property or method <validation-property-target>`
 Options     - `allowNull`_
             - `groups`_
             - `message`_
+            - `normalizer`_
             - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\NotBlank`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\NotBlankValidator`
@@ -110,4 +111,15 @@ Parameter        Description
 ``{{ value }}``  The current (invalid) value
 ===============  ==============================================================
 
+normalizer
+~~~~~~~~~~
+
+**type**: ``string`` **default**: ``null``
+
+If the given value is a ``string``, this option can be used to normalize it while
+checking if it is valid. A ``callable`` must be passed.
+
+For example, you may want to use :phpfunction:`trim` to ignore leading and
+trailing whitespace during validation.
+
 .. include:: /reference/constraints/_payload-option.rst.inc

reference/constraints/Regex.rst

@@ -10,6 +10,7 @@ Options     - `groups`_
             - `match`_
             - `message`_
             - `pattern`_
+            - `normalizer`_
             - `payload`_
 Class       :class:`Symfony\\Component\\Validator\\Constraints\\Regex`
 Validator   :class:`Symfony\\Component\\Validator\\Constraints\\RegexValidator`
@@ -287,4 +288,5 @@ does *not* match this regular expression (via the :phpfunction:`preg_match`
 PHP function). However, if `match`_ is set to false, then validation will
 fail if the input string *does* match this pattern.
 
+.. include:: /reference/constraints/_normalizer-option.rst.inc
 .. include:: /reference/constraints/_payload-option.rst.inc

reference/constraints/Url.rst

@@ -9,6 +9,7 @@ Options     - `checkDNS`_
             - `dnsMessage`_
             - `groups`_
             - `message`_
+            - `normalizer`_
             - `payload`_
             - `protocols`_
             - `relativeProtocol`_
@@ -319,6 +320,7 @@ Parameter        Description
             }
         }
 
+.. include:: /reference/constraints/_normalizer-option.rst.inc
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 protocols

reference/constraints/Uuid.rst

@@ -10,6 +10,7 @@ UUID versions can also be restricted using a whitelist.
 Applies to  :ref:`property or method <validation-property-target>`
 Options     - `groups`_
             - `message`_
+            - `normalizer`_
             - `payload`_
             - `strict`_
             - `versions`_
@@ -98,6 +99,7 @@ Parameter        Description
 ``{{ value }}``  The current (invalid) value
 ===============  ==============================================================
 
+.. include:: /reference/constraints/_normalizer-option.rst.inc
 .. include:: /reference/constraints/_payload-option.rst.inc
 
 strict

reference/constraints/_normalizer-option.rst.inc

@@ -0,0 +1,10 @@
+normalizer
+~~~~~~~~~~
+
+**type**: ``string`` **default**: ``null``
+
+This option allows a ``callable`` to be passed in order to normalize the given
+value while checking if it is valid.
+
+For example, you may want to use :phpfunction:`trim` to ignore leading and
+trailing whitespace during validation.