minor #19764 Documenting items type in the MapRequestPayload attribute (yceruto)

javiereguiluz · javiereguiluz · commit 259d28da9e61 · 2024-04-16T16:03:46.000+02:00
This PR was merged into the 7.1 branch. Discussion ---------- Documenting items type in the MapRequestPayload attribute Fixes #19761 PR: symfony/symfony#54385 Commits ------- fa1934c Documenting items type in the MapRequestPayload attribute
diff --git a/controller.rst b/controller.rst
@@ -555,6 +555,32 @@ if you want to map a nested array of specific DTOs::
         ) {}
     }
 
+Nevertheless, if you want to send the array of payloads directly like this:
+
+.. code-block:: json
+
+    [
+        {
+            "firstName": "John",
+            "lastName": "Smith",
+            "age": 28
+        },
+        {
+            "firstName": "Jane",
+            "lastName": "Doe",
+            "age": 30
+        }
+    ]
+
+Map the parameter as an array and configure the type of each element in the attribute::
+
+    public function dashboard(
+        #[MapRequestPayload(type: UserDTO::class)] array $users
+    ): Response
+    {
+        // ...
+    }
+
 Managing the Session
 --------------------
 
