New normalizers

components/serializer.rst

@@ -511,6 +511,26 @@ There are several types of normalizers available:
 
     Objects are normalized to a map of property names to property values.
 
+::class:`Symfony\\Component\\Serializer\\Normalizer\\JsonSerializableNormalizer`
+    This normalizer works with classes that implement ``\JsonSerializable``.
+
+    It will call the ``jsonSerialize`` method and then further normalize the result.
+    This means that nested ``JsonSerializable`` classes will also be normalized.
+
+    This normalizer is particularly helpful when you want to gradually migrate
+    from an existing codebase using simple ``json_encode`` to the full Symfony
+    Serializer by allowing you to mix which normalizers are used for which classes.
+
+    Unlike with ``json_encode`` circular references are handled.
+
+::class:`Symfony\\Component\\Serializer\\Normalizer\\DateTimeNormalizer`
+    This normalizer converts ``\DateTime`` objects (or anything that implements
+    ``\DateTimeInterface``) into strings. By default it uses the RFC3339 format.
+
+::class:`Symfony\\Component\\Serializer\\Normalizer\\DataUriNormalizer`
+    This normalizer converts ``\SplFileInfo`` objects into a data URI string
+    (``data:...``) such that files can be embedded into serialized data.
+
 Handling Circular References
 ----------------------------