@@ -21,10 +21,10 @@ Configuration
21
21
* `test `_
22
22
* `trusted_proxies `_
23
23
* `form `_
24
- * enabled
24
+ * :ref: ` enabled < form-enabled >`
25
25
* `csrf_protection `_
26
- * enabled
27
- * field_name
26
+ * :ref: ` enabled < csrf-protection-enabled >`
27
+ * ` field_name `_
28
28
* `session `_
29
29
* `name `_
30
30
* `cookie_lifetime `_
@@ -49,6 +49,7 @@ Configuration
49
49
* :ref: `enabled <translator.enabled >`
50
50
* `fallback `_
51
51
* `validation `_
52
+ * :ref: `enabled <validation-enabled >`
52
53
* `cache `_
53
54
* `enable_annotations `_
54
55
* `translation_domain `_
@@ -196,9 +197,40 @@ see :doc:`/cookbook/request/load_balancer_reverse_proxy`.
196
197
form
197
198
~~~~
198
199
200
+ .. _form-enabled :
201
+
202
+ enabled
203
+ .......
204
+
205
+ **type **: ``boolean `` **default **: ``false ``
206
+
207
+ Whether or not to enable support for the Form component.
208
+
209
+ You will also have to disable form support if you want to
210
+ :ref: `disable the validation support <validation-enabled >`.
211
+
199
212
csrf_protection
200
213
~~~~~~~~~~~~~~~
201
214
215
+ .. _csrf-protection-enabled :
216
+
217
+ enabled
218
+ .......
219
+
220
+ **type **: ``boolean `` **default **: ``true `` if form support is enabled, ``false ``
221
+ otherwise
222
+
223
+ This option can be used to disable CSRF protection of forms. You need to
224
+ disable CSRF protection to be able to disable session. For example, this
225
+ is useful when you only use forms in an API-only website.
226
+
227
+ field_name
228
+ ..........
229
+
230
+ **type **: ``string `` **default **: ``"_token" ``
231
+
232
+ The name of the hidden field used to render the :ref: `CSRF token <forms-csrf >`.
233
+
202
234
session
203
235
~~~~~~~
204
236
@@ -524,6 +556,16 @@ For more details, see :doc:`/book/translation`.
524
556
validation
525
557
~~~~~~~~~~
526
558
559
+ .. _validation-enabled :
560
+
561
+ enabled
562
+ .......
563
+
564
+ **type **: ``boolean `` **default **: ``true `` if :ref: `form support is enabled <form-enabled >`,
565
+ ``false `` otherwise
566
+
567
+ Whether or not to enable validation support.
568
+
527
569
cache
528
570
.....
529
571
0 commit comments