[RFC][DependencyInjection] Deprecate the “@required” annotation

Symfony (including 6.2) supports the @required annotation, see for example with Symfony 5.4: https://symfony.com/doc/5.4/service_container/autowiring.html

Tests have to cover a wide range of different cases:

Line 244 in bc5fea4

/** @inheritdoc*/ // <- brackets are missing on purpose

Line 312 in bc5fea4

/** @required <tab> prefix is on purpose */

The proposal is to deprecate the @required annotation and suggest to replace it with Symfony\Contracts\Service\Attribute\Required.

This would simplify the codebase of Symfony at the next major release and encourage users to migrate from annotations to attributes.

- /**
-  @required
- /
+ #[\Symfony\Contracts\Service\Attribute\Required]

Provide feedback