Add COLLECT_EXTRA_ATTRIBUTES_ERRORS doc

NorthBlue333 · NorthBlue333 · commit 1fc5d75c68a5 · 2022-06-12T22:25:02.000+02:00
diff --git a/components/serializer.rst b/components/serializer.rst
@@ -195,6 +195,11 @@ when constructing the normalizer::
         AbstractNormalizer::ALLOW_EXTRA_ATTRIBUTES => false,
     ]);
 
+.. tip::
+
+    If your object contains nested objects, an ``ExtraAttributesException`` will be thrown at first nested object containing
+    extra attributes. When this happens, you can use :ref:`Attributes Groups section <component-serializer-collecting-extra-attributes-errors-while-denormalizing>`
+
 Deserializing in an Existing Object
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -1266,8 +1271,8 @@ Collecting Type Errors While Denormalizing
 ------------------------------------------
 
 When denormalizing a payload to an object with typed properties, you'll get an
-exception if the payload contains properties that don't have the same type as
-the object.
+exception ``NotNormalizableValueException`` if the payload contains properties that don't have the same type as
+the object, at first incorrect type.
 
 In those situations, use the ``COLLECT_DENORMALIZATION_ERRORS`` option to
 collect all exceptions at once, and to get the object partially denormalized::
@@ -1291,6 +1296,34 @@ collect all exceptions at once, and to get the object partially denormalized::
         return $this->json($violations, 400);
     }
 
+Collecting Extra Attributes Errors While Denormalizing
+------------------------------------------
+
+When denormalizing a payload with ``ALLOW_EXTRA_ATTRIBUTES`` set to false to an object with nested objects, you'll get an
+exception at first ``ExtraAttributesException`` in nested objects.
+
+In those situations, use the ``COLLECT_EXTRA_ATTRIBUTES_ERRORS`` option to
+collect all exceptions at once, and to get the object partially denormalized::
+
+    try {
+        $dto = $serializer->deserialize($request->getContent(), MyDto::class, 'json', [
+            DenormalizerInterface::COLLECT_EXTRA_ATTRIBUTES_ERRORS => true,
+        ]);
+    } catch (PartialDenormalizationException $e) {
+        $violations = new ConstraintViolationList();
+        /** @var NotNormalizableValueException $exception */
+        foreach ($e->getErrors() as $exception) {
+            $message = sprintf('The type must be one of "%s" ("%s" given).', implode(', ', $exception->getExpectedTypes()), $exception->getCurrentType());
+            $parameters = [];
+            if ($exception->canUseMessageForUser()) {
+                $parameters['hint'] = $exception->getMessage();
+            }
+            $violations->add(new ConstraintViolation($message, '', $parameters, null, $exception->getPath(), null));
+        }
+
+        return $this->json($violations, 400);
+    }
+
 Handling Circular References
 ----------------------------
 
