Merge branch '3.4' into 4.2

javiereguiluz · javiereguiluz · commit 32e7bfc5c4ba · 2019-03-07T17:33:52.000+01:00
* 3.4:
  Show example on using a DateTimeImmutable object
  Describe actual traversal behaviour
diff --git a/reference/constraints/Valid.rst b/reference/constraints/Valid.rst
@@ -264,6 +264,6 @@ traverse
 
 **type**: ``boolean`` **default**: ``true``
 
-If this constraint is applied to a property that holds an array of objects,
-then each object in that array will be validated only if this option is
-set to ``true``.
+If this constraint is applied to a ``Traversable``, then all containing values
+will be validated if this option is set to ``true``. This option is ignored on
+arrays: Arrays are traversed in either case. Keys are not validated.
diff --git a/reference/forms/types/date.rst b/reference/forms/types/date.rst
@@ -66,8 +66,13 @@ field as **three different choice fields**::
         'widget' => 'choice',
     ]);
 
-If your underlying date is *not* a ``DateTime`` object (e.g. it's a unix timestamp),
-configure the `input`_ option.
+If your underlying date is *not* a ``DateTime`` object (e.g. it's a unix
+timestamp or a ``DateTimeImmutable`` object), configure the `input`_ option::
+
+    $builder->add('publishedAt', DateType::class, [
+        'widget' => 'choice',
+        'input'  => 'datetime_immutable'
+    ]);
 
 Rendering a single HTML5 Textbox
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
