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

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly
8000
Appearance settings

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 deletions
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