[HttpKernel] Allow using #[WithLogLevel] for setting custom log level for exceptions

[angelov]

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

With these changes, we're extending the functionality for setting a custom log level for a given exception by introducing a new WithLogLevel attribute.

Example:

#[WithLogLevel(\Psr\Log\LogLevel::CRITICAL)]
class AccountBalanceIsNegative extends \Exception
{
}

This will have a lower priority compared to the log level set using the option in the configuration files.
(Meaning that if we have both an attribute declared on an exception class, and another level set for the same class in the configuration, the one from the configuration will be used.)

[nicolas-grekas]

Thanks. Don't miss adding a changelog entry.

[derrabus]

Thank you for working on this. Looks like a nice feature.

[fabpot]

Can we use a use statement here to simplify the code?

Suggested change

	* @param \Psr\Log\LogLevel::* $level
	* @param LogLevel::* $level

[angelov]

We cannot simplify it to just LogLevel because the attribute class has the same name, so we'll have to add an alias, thus I don't see any benefit from adding the use statement.

[derrabus]

This naming conflict is indeed unfortunate because the one thing you want to pass to the constructor of the LogLevel attribute is a LogLevel constant. This makes the everyday use of the attribute a bit cumbersome. Maybe we should rename the attribute?

[angelov]

I'm open to suggestions as I couldn't think of a better name for the attribute.

[derrabus]

Dunno… AsLogLevel, WithLogLevel, AssignLogLevel, … 🤷🏻‍♂️

[nicolas-grekas]

MapLogLevel?
We already have a few Map* attributes
Worth renaming HttpStatus to MapHttpStatus?
Another idea could be At*

[chalasr]

Not sure about Map as it's used for argument mapping/binding/resolution AFAIK, and At feels weird for the status code. Another proposal: #[ToLogLevel] & #[ToHttpStatus]

[angelov]

I renamed the class to WithLogLevel as it makes most sense to me. I can change it to something else if needed. I will also submit a PR to update the HttpStatus attribute accordingly after this is merged.

[fabpot]

Thank you @angelov.

[fabpot]

As a follow-up, I've created #48876 to rename HttpStatus to WithHttpStatus.