Skip to content

Commit fed4d14

Browse files
committed
[#11344] Some minor formatting changes
1 parent bda85fa commit fed4d14

File tree

1 file changed

+9
-7
lines changed

1 file changed

+9
-7
lines changed

components/serializer.rst

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -214,15 +214,17 @@ The ``OBJECT_TO_POPULATE`` is only used for the top level object. If that object
214214
is the root of a tree structure, all child elements that exist in the
215215
normalized data will be re-created with new instances.
216216

217-
..versionadded:: 4.3
217+
When the ``AbstractObjectNormalizer::DEEP_OBJECT_TO_POPULATE`` option is set to
218+
true, existing children of the root ``OBJECT_TO_POPULATE`` are updated from the
219+
normalized data, instead of the denormalizer re-creating them. Note that
220+
``DEEP_OBJECT_TO_POPULATE`` only works for single child objects, but not for
221+
arrays of objects. Those will still be replaced when present in the normalized
222+
data.
218223

219-
Symfony 4.3 introduces a new option ``AbstractObjectNormalizer::DEEP_OBJECT_TO_POPULATE``.
220-
When this flag is set to true, existing children of the root ``OBJECT_TO_POPULATE`` are
221-
updated from the normalized data, instead of the denormalizer re-creating them.
224+
.. versionadded:: 4.3
222225

223-
Note that ``DEEP_OBJECT_TO_POPULATE`` only works for single child objects,
224-
but not for arrays of objects. Those will still be replaces when present in
225-
the normalized data.
226+
The ``AbstractObjectNormalizer::DEEP_OBJECT_TO_POPULATE`` option was
227+
introduced in Symfony 4.3.
226228

227229
.. _component-serializer-attributes-groups:
228230

0 commit comments

Comments
 (0)