[Security] Add argument $exceptionCode to #[IsGranted]

[mazumba]

Q	A
Branch?	6.3
Bug fix?	no
New feature?	yes
Deprecations?	no
Tickets	no
License	MIT
Doc PR

In my current project, we transform HttpExceptions into a custom JsonResponse with fields like
success: false, message: "No access to account.", exceptionCode: 10010. To throw the exception, the IsGranted-attribute is used with a custom voter. The problem here is, that, in order to return a specific exception-code, we have to throw the Http-exception inside the voter, instead of just returning false as intended.
This is only viable in our case, since we have priority as our access decision strategy.

My suggestion here is to extend the properties of IsGranted by exceptionCode and throw a HttpException inside the IsGrantedListener, whenever the property is used. So the same behaviour as with the statusCode property.

Example:
#[IsGranted(attribute: 'ROLE_ADMIN', message: 'No access to account.', statusCode: 403, exceptionCode: 10010)]

[carsonbot]

Hey!

I see that this is your first PR. That is great! Welcome!

Symfony has a contribution guide which I suggest you to read.

In short:

• Always add tests
• Keep backward compatibility (see https://symfony.com/bc).
• Bug fixes must be submitted against the lowest maintained branch where they apply (see https://symfony.com/releases)
• Features and deprecations must be submitted against the 6.3 branch.

Review the GitHub status checks of your pull request and try to solve the reported issues. If some tests are failing, try to see if they are failing because of this change.

When two Symfony core team members approve this change, it will be merged and you will become an official Symfony contributor!
If this PR is merged in a lower version branch, it will be merged up to all maintained branches within a few days.

I am going to sit back now and wait for the reviews.

Cheers!

Carsonbot

[nicolas-grekas]

Thank you @mazumba.