symfony
diff --git a/‎reference/constraints/NotBlank.rst
Copy file name to clipboardExpand all lines: reference/constraints/NotBlank.rst
+16-8Lines changed: 16 additions & 8 deletions b/‎reference/constraints/NotBlank.rst
Copy file name to clipboardExpand all lines: reference/constraints/NotBlank.rst
+16-8Lines changed: 16 additions & 8 deletions
@@ -2,19 +2,15 @@ NotBlank
 ========
 
 Validates that a value is not blank - meaning not equal to a blank string,
-a blank array, ``null`` or ``false``::
-
-    if (false === $value || (empty($value) && '0' != $value)) {
-        // validation will fail
-    }
-
-To force that a value is simply not equal to ``null``, see the
+a blank array, ``false`` or ``null`` (null behavior is configurable). To check
+that a value is not equal to ``null``, see the
 :doc:`/reference/constraints/NotNull` constraint.
 
 +----------------+------------------------------------------------------------------------+
 | Applies to     | :ref:`property or method <validation-property-target>`                 |
 +----------------+------------------------------------------------------------------------+
-| Options        | - `message`_                                                           |
+| Options        | - `allowNull`_                                                         |
+|                | - `message`_                                                           |
 |                | - `payload`_                                                           |
 +----------------+------------------------------------------------------------------------+
 | Class          | :class:`Symfony\\Component\\Validator\\Constraints\\NotBlank`          |
@@ -87,6 +83,18 @@ class were not blank, you could do the following:
 Options
 -------
 
+allowNull
+~~~~~~~~~
+
+**type**: ``bool`` **default**: ``false``
+
+If set to ``true``, ``null`` values are considered valid and won't trigger a
+constraint violation.
+
+.. versionadded:: 4.3
+
+    The ``allowNull`` option was introduced in Symfony 4.3.
+
 message
 ~~~~~~~