[Security] Add tokenSource parameter for CSRF token validation sources

Author: webda2l

security/csrf.rst

@@ -321,6 +321,29 @@ array, the attribute is ignored for that request, and no CSRF validation occurs:
         // ... delete the object
     }
 
+You can also choose where the CSRF token is read from using the ``tokenSource`` parameter
+This is a bitfield allowing you to combine these sources:
+
+* ``IsCsrfTokenValid::SOURCE_PAYLOAD`` (default): request payload (POST body / json)
+* ``IsCsrfTokenValid::SOURCE_QUERY``: query string
+* ``IsCsrfTokenValid::SOURCE_HEADER``: request headers
+
+Example:
+
+.. code-block:: php
+
+    #[IsCsrfTokenValid(
+        'delete-item',
+        tokenKey: 'token',
+        tokenSource: IsCsrfTokenValid::SOURCE_PAYLOAD | IsCsrfTokenValid::SOURCE_QUERY
+    )]
+    public function delete(Post $post): Response
+    {
+        // ... delete the object
+    }
+
+The token will be checked in each selected source, in order, and validation fails if none match.
+
 .. versionadded:: 7.1
 
     The :class:`Symfony\\Component\\Security\\Http\\Attribute\\IsCsrfTokenValid`
@@ -330,6 +353,10 @@ array, the attribute is ignored for that request, and no CSRF validation occurs:
 
     The ``methods`` parameter was introduced in Symfony 7.3.
 
+.. versionadded:: 7.4
+
+    The ``tokenSource`` parameter was introduced in Symfony 7.4.
+
 CSRF Tokens and Compression Side-Channel Attacks
 ------------------------------------------------