[Serializer] Allow to access to the context and various other infos in callbacks and max depth handler

dunglas · dunglas · commit a4dad43a2742 · 2018-09-10T21:57:34.000+02:00
diff --git a/components/serializer.rst b/components/serializer.rst
@@ -545,10 +545,9 @@ When serializing, you can set a callback to format a specific object property::
     $encoder = new JsonEncoder();
     $normalizer = new GetSetMethodNormalizer();
 
-    $callback = function ($dateTime) {
-        return $dateTime instanceof \DateTime
-            ? $dateTime->format(\DateTime::ISO8601)
-            : '';
+    $callback = function ($innerObject, $outerObject, string $attributeName, string $format = null, array $context = null) {
+        // Every parameters can be omitted if not used
+        return $dateTime instanceof \DateTime ? $dateTime->format(\DateTime::ISO8601) : '';
     };
 
     $normalizer->setCallbacks(array('createdAt' => $callback));
@@ -563,6 +562,11 @@ When serializing, you can set a callback to format a specific object property::
     $serializer->serialize($person, 'json');
     // Output: {"name":"cordoval", "age": 34, "createdAt": "2014-03-22T09:43:12-0500"}
 
+.. versionadded:: 4.2
+    The ``$outerObject``, ``$attributeName``, ``$format`` and ``$context``
+    parameters of the callback were introduced in Symfony 4.2.
+
+
 .. _component-serializer-normalizers:
 
 Normalizers
@@ -964,8 +968,9 @@ having unique identifiers::
 
     $classMetadataFactory = new ClassMetadataFactory(new AnnotationLoader(new AnnotationReader()));
     $normalizer = new ObjectNormalizer($classMetadataFactory);
-    $normalizer->setMaxDepthHandler(function ($foo) {
-        return '/foos/'.$foo->id;
+    $normalizer->setMaxDepthHandler(function ($innerObject, $outerObject, string $attributeName, string $format = null, array $context = null) {
+        // Every parameters can be omitted if not used
+        return '/foos/'.$innerObject->id;
     });
 
     $serializer = new Serializer(array($normalizer));
@@ -984,6 +989,10 @@ having unique identifiers::
 .. versionadded:: 4.1
     The ``setMaxDepthHandler()`` method was introduced in Symfony 4.1.
 
+.. versionadded:: 4.2
+    The ``$outerObject``, ``$attributeName``, ``$format`` and ``$context``
+    parameters of ``setMaxDepthHandler()`` were introduced in Symfony 4.2.
+
 Handling Arrays
 ---------------
 
