minor #18103 [Security] Add statusCode and message arguments to #[IsGranted] (alexandre-daubois)

This PR was squashed before being merged into the 6.2 branch.

Discussion
----------

[Security] Add `statusCode` and `message` arguments to `#[IsGranted]`

Following #18101 (comment)

Commits
-------

149d33b [Security] Add `statusCode` and `message` arguments to `#[IsGranted]`

Author: OskarStark

security.rst

@@ -2299,13 +2299,30 @@ the ``ROLE_SUPER_ADMIN`` permission:
     #[IsGranted('ROLE_ADMIN')]
     class AdminController extends AbstractController
     {
-        #[IsGranted('ROLE_SUPER_ADMIN')]
+        // Optionally, you can set a custom message that will be displayed to the user
+        #[IsGranted('ROLE_SUPER_ADMIN', message: 'You are not allowed to access the admin dashboard.')]
         public function adminDashboard(): Response
         {
             // ...
         }
     }
 
+If you want to use a custom status code instead of the default one (which
+is 403), this can be done by setting with the ``statusCode`` argument::
+
+    // src/Controller/AdminController.php
+    // ...
+
+    use Symfony\Component\Security\Http\Attribute\IsGranted;
+
+    #[IsGranted('ROLE_ADMIN', statusCode: 423)]
+    class AdminController extends AbstractController
+    {
+        // ...
+    }
+
+The default code is 403.
+
 .. versionadded:: 6.2
 
     The ``#[IsGranted()]`` attribute was introduced in Symfony 6.2.