minor #21301 [Security] add methods argument to #[IsGranted] to restrict access by HTTP method (santysisi)

This PR was merged into the 7.4 branch.

Discussion
----------

[Security] add `methods` argument to `#[IsGranted]` to restrict access by HTTP method

Closes #21296

Add support for `methods` argument in `#[IsGranted]` attribute to restrict access by HTTP methods

Commits
-------

f54811f [Security] add `methods` argument to #[IsGranted] to restrict access by HTTP method

Author: xabbuh

security.rst

@@ -2543,6 +2543,29 @@ You can also extend the ``IsGranted`` attribute to create meaningful shortcuts::
     The :class:`Symfony\\Component\\Security\\Http\\Attribute\\IsGranted`
     attribute is extendable since Symfony 7.4.
 
+You can restrict access validation to specific HTTP methods
+by using the ``methods`` argument::
+
+    // src/Controller/AdminController.php
+    // ...
+
+    use Symfony\Component\Security\Http\Attribute\IsGranted;
+
+    #[IsGranted('ROLE_ADMIN', methods: 'POST')]
+    class AdminController extends AbstractController
+    {
+        // You can also specify an array of methods
+        #[IsGranted('ROLE_SUPER_ADMIN', methods: ['GET', 'PUT'])]
+        public function adminDashboard(): Response
+        {
+            // ...
+        }
+    }
+
+.. versionadded:: 7.4
+
+    The ``methods`` argument was introduced in Symfony 7.4.
+
 .. _security-template:
 
 Access Control in Templates