[HttpKernel] Add optional $className param to ControllerEvent::getAttributes()

[HypeMC]

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

A minor DX improvement since most of the time only one type of attribute is needed, eg:

public function onKernelControllerArguments(ControllerArgumentsEvent $event)
{
    $attributes = $event->getAttributes(SomeAttribute::class);

    // ...
}

[nicolas-grekas]

Is this really worth it?

-$attributes = $event->getAttributes(SomeAttribute::class);
+$attributes = $event->getAttributes()[SomeAttribute::class] ?? null;

[stof]

@nicolas-grekas the difference is that the new argument has a generic signature, telling SA tools that all returned objects are an instance of the provided class name.
For the case of returning all attributes grouped by a class name, there is no interoperable way to indicate that in phpdoc (Psalm has a class-string-map type, but no other tool support it)

[nicolas-grekas]

Wouldn't this work?
@return array<class-string<T>, list<T>>

[stof]

@nicolas-grekas no. This won't work as it would force using the same T (and inferring it from somewhere).

That's precisely why Psalm introduced a class-string-map type, which would be exactly what we need here if it was interoperable.

[fabpot]

Thank you @HypeMC.