minor #19293 [HttpKernel] [Value Resolver] Added RequestPayloadValueResolver section (mattjanssen)

javiereguiluz · javiereguiluz · commit 20dca7d25d9e · 2023-12-26T09:17:48.000+01:00
This PR was merged into the 6.3 branch. Discussion ---------- [HttpKernel] [Value Resolver] Added `RequestPayloadValueResolver` section Fix #19247 Commits ------- 93cec5f [Value Resolver] Added `RequestPayloadValueResolver` section
diff --git a/controller.rst b/controller.rst
@@ -388,6 +388,8 @@ attribute, arguments of your controller's action can be automatically fulfilled:
     The :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapQueryParameter` attribute
     was introduced in Symfony 6.3.
 
+.. _controller-mapping-query-string:
+
 Mapping The Whole Query String
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -445,6 +447,8 @@ You can customize the validation groups used during the mapping thanks to the
     The :class:`Symfony\\Component\\HttpKernel\\Attribute\\MapQueryString` attribute
     was introduced in Symfony 6.3.
 
+.. _controller-mapping-request-payload:
+
 Mapping Request Payload
 ~~~~~~~~~~~~~~~~~~~~~~~
 
diff --git a/controller/value_resolver.rst b/controller/value_resolver.rst
@@ -79,6 +79,19 @@ Symfony ships with the following value resolvers in the
 
         The ``BackedEnumValueResolver`` and ``EnumRequirement`` were introduced in Symfony 6.1.
 
+
+:class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentResolver\\RequestPayloadValueResolver`
+    Maps the request payload or the query string into the type-hinted object.
+
+    Because this is a :ref:`targeted value resolver <value-resolver-targeted>`,
+    you'll have to use either the :ref:`MapRequestPayload <controller-mapping-request-payload>`
+    or the :ref:`MapQueryString <controller-mapping-query-string>` attribute
+    in order to use this resolver.
+
+    .. versionadded:: 6.3
+
+        The ``RequestPayloadValueResolver`` was introduced in Symfony 6.3.
+
 :class:`Symfony\\Component\\HttpKernel\\Controller\\ArgumentResolver\\RequestAttributeValueResolver`
     Attempts to find a request attribute that matches the name of the argument.
 
@@ -430,6 +443,8 @@ command to see which argument resolvers are present and in which order they run:
 You can also configure the name passed to the ``ValueResolver`` attribute to target
 your resolver. Otherwise it will default to the service's id.
 
+.. _value-resolver-targeted:
+
 ``controller.targeted_value_resolver``
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
