8000 Added a note about the usage of NotBlank · symfony/symfony-docs@24ed17e · GitHub
[go: up one dir, main page]
Skip to content

Commit 24ed17e

Browse files
javiereguiluzjaviereguiluz
committed
Added a note about the usage of NotBlank
1 parent 7a31300 commit 24ed17e

21 files changed

+47
-0
lines changed

‎reference/constraints/Bic.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -83,6 +83,8 @@ will contain a Business Identifier Code (BIC).
8383
}
8484
}
8585
86+
.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
87+
8688
Available Options
8789
-----------------
8890

‎reference/constraints/CardScheme.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -96,6 +96,8 @@ on an object that will contain a credit card number.
9696
}
9797
}
9898
99+
.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
100+
99101
Available Options
100102
-----------------
101103

‎reference/constraints/Country.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -73,6 +73,8 @@ Basic Usage
7373
}
7474
}
7575
76+
.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
77+
7678
Options
7779
-------
7880

‎reference/constraints/Currency.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -79,6 +79,8 @@ a valid currency, you could do the following:
7979
}
8080
}
8181
82+
.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
83+
8284
Options
8385
-------
8486

‎reference/constraints/Date.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -75,6 +75,8 @@ Basic Usage
7575
}
7676
}
7777
78+
.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
79+
7880
Options
7981
-------
8082

‎reference/constraints/DateTime.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -75,6 +75,8 @@ Basic Usage
7575
}
7676
}
7777
78+
.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
79+
7880
Options
7981
-------
8082

‎reference/constraints/Email.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -88,6 +88,8 @@ Basic Usage
8888
}
8989
}
9090
91+
.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
92+
9193
Options
9294
-------
9395

‎reference/constraints/File.rst

Lines changed: 2 additions & 0 dele F438 tions
Original file line numberDiff line numberDiff line change
@@ -150,6 +150,8 @@ The ``bioFile`` property is validated to guarantee that it is a real file.
150150
Its size and mime type are also validated because the appropriate options
151151
have been specified.
152152

153+
.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
154+
153155
Options
154156
-------
155157

‎reference/constraints/Iban.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -93,6 +93,8 @@ will contain an International Bank Account Number.
9393
}
9494
}
9595
96+
.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
97+
9698
Available Options
9799
-----------------
98100

‎reference/constraints/Ip.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -76,6 +76,8 @@ Basic Usage
7676
}
7777
}
7878
79+
.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
80+
7981
Options
8082
-------
8183

‎reference/constraints/Isbn.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -104,6 +104,8 @@ on an object that will contain an ISBN.
104104
}
105105
}
106106
107+
.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
108+
107109
Available Options
108110
-----------------
109111

‎reference/constraints/Issn.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -79,6 +79,8 @@ Basic Usage
7979
}
8080
}
8181
82+
.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
83+
8284
Options
8385
-------
8486

‎reference/constraints/Language.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -74,6 +74,8 @@ Basic Usage
7474
}
7575
}
7676
77+
.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
78+
7779
Options
7880
-------
7981

‎reference/constraints/Length.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -110,6 +110,8 @@ and "50", you might add the following:
110110
}
111111
}
112112
113+
.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
114+
113115
Options
114116
-------
115117

‎reference/constraints/Locale.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,6 +78,8 @@ Basic Usage
7878
}
7979
}
8080
81+
.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
82+
8183
Options
8284
-------
8385

‎reference/constraints/Luhn.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -85,6 +85,8 @@ will contain a credit card number.
8585
}
8686
}
8787
88+
.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
89+
8890
Available Options
8991
-----------------
9092

‎reference/constraints/Regex.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -161,6 +161,8 @@ it a custom message:
161161
}
162162
}
163163
164+
.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
165+
164166
Options
165167
-------
166168

‎reference/constraints/Time.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,6 +78,8 @@ of the day when the event starts:
7878
}
7979
}
8080
81+
.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
82+
8183
Options
8284
-------
8385

‎reference/constraints/Url.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -76,6 +76,8 @@ Basic Usage
7676
}
7777
}
7878
79+
.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
80+
7981
Options
8082
-------
8183

‎reference/constraints/Uuid.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,6 +78,8 @@ Basic Usage
7878
}
7979
}
8080
81+
.. include:: /reference/constraints/_empty-values-are-valid.rst.inc
82+
8183
Options
8284
-------
8385

‎reference/constraints/_empty-values-are-valid.rst.inc

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
.. note::
2+
3+
As with most of the other constraints, ``null`` values and empty strings
4+
are considered valid values. Otherwise, in addition to validating this value,
5+
you would also be requiring it, making it impossible to be optional. That's
6+
why it's common to combine this constraint with
7+
:doc:`NotBlank </reference/constraints/NotBlank>`.

0 commit comments

Comments
 (0)
0