Symfony 7: A tribute to Attributes @nicolasgrekas

👌 👍 Auto-discovery Auto-configuration Auto-wiring #[Attributes]

symfony.com/releases @nicolasgrekas

Backward Compatibility Promise • Upgrade every month for bug fixes • Upgrade every 6 months for features @nicolasgrekas "extra": { "symfony": { "require": "6.4.*" } }

Continuous Upgrade Path • Fix deprecations every 6 months • Upgrade every 2 years for new major @nicolasgrekas "require": { "php": ">=8.2" }

🎉 Symfony 7 • Remove deprecated code paths • Add native return types • Add native types to public|protectedproperties @nicolasgrekas

RIP Doctrine Annotations ⚠️ PHP 8 introduced attributes, which are a native replacement for annotations @nicolasgrekas

RIP SensioFrameworkExtraBundle @Route @Entity @IsGranted @Security @ParamConverter @Cache @Template @nicolasgrekas

😍 #[Attributes] @nicolasgrekas #[Route(path: '/', name: 'home')] // return list ReflectionMethod::getAttributes(); // return new Route(path: '/', name: 'home'); ReflectionAttribute::newInstance(); // return ['path' => '/', 'name' => 'home']; ReflectionAttribute::getArguments();

Attributes are ignorable; they don't create coupling Attributes are useful hints telling how some code could be used @nicolasgrekas

@nicolasgrekas 422 Unprocessable Entity? class DiscountExpired extends DiscountException { // ... }

@nicolasgrekas Decoupled! #[WithHttpStatus(422)] class DiscountExpired extends DiscountException { // ... }

@nicolasgrekas services: _defaults: autowire: true # Look at parameter types to auto-inject deps autoconfigure: true # Look at parent types to auto-register classes # Load every class in a namespace/directory as a service App\: resource: '../src/' # Add more service definitions when explicit configuration is needed config/services.yaml

@nicolasgrekas FrameworkBundle's FrameworkExtension $container->registerForAutoconfiguration(Command::class) $container->registerForAutoconfiguration(AbstractController::class) $container->registerForAutoconfiguration(FormTypeInterface::class) $container->registerForAutoconfiguration(EventSubscriberInterface::class) $container->registerForAutoconfiguration(ResetInterface::class) $container->registerForAutoconfiguration(MessageHandlerInterface::class) // ...

@nicolasgrekas FrameworkBundle's FrameworkExtension $container->registerAttributeForAutoconfiguration(AsEventListener::class, ...) $container->registerAttributeForAutoconfiguration(AsController::class, ...) $container->registerAttributeForAutoconfiguration(AsRemoteEventConsumer::class, ...) $container->registerAttributeForAutoconfiguration(AsMessageHandler::class, ...) $container->registerAttributeForAutoconfiguration(AsSchedule::class, ...) // ...

@nicolasgrekas Just Enjoy on your side #[AsEventListener] class MyRequestListener { public function __invoke(RequestEvent $event): void { // ... } }

@nicolasgrekas #[AutoconfigureTag] interface ChannelInterface { } Define your rules

@nicolasgrekas Enjoy your rules class ChannelBroadcaster { public function __construct( #[AutowireIterator(ChannelInterface::class)] iterable $channels ) { // ... }

@nicolasgrekas #[AsAlias(ChannelInterface::class)] class DefaultChannel implements ChannelInterface {

🧙‍♀️ Dependency Injection #[AsDecorator] #[AsTaggedItem] #[AutowireCallable] #[AutowireDecorated] #[AutowireLocator] #[AutowireServiceClosure] #[Exclude] #[Required] #[SubscribedService] #[Target] #[When] @nicolasgrekas

@nicolasgrekas #[Autoconfigure(lazy: true)] class PlotFactory { public function __construct( #[Autowire(param: 'kernel.debug')] private bool $debug, private HeavyDependency $heavyDependency, ) { } }

public function __construct( #[AutowireLocator([ 'router' => RouterInterface::class, 'slugger' => '?'.SluggerInterface::class, ])] ContainerInterface $container, )

@nicolasgrekas public function __construct( #[AutowireCallable(UriTemplate::class, 'expand')] UriExpanderInterface $expander, ) new class($uriTemplate->expand(...)) implements UriExpanderInterface { public function __construct( private \Closure $closure, ) { } public function expand(string $url, array $vars): string { return $this->closure->__invoke($url, $vars); } } $uriTemplate->expand(...)

🕹️ Controllers #[CurrentUser] #[MapDateTime] #[MapEntity] #[MapQueryParameter] #[MapQueryString] #[MapRequestPayload] #[ValueResolver] @nicolasgrekas

@nicolasgrekas #[Route('/blog')] public function blog( #[MapQueryParameter] int $page = 1, )

@nicolasgrekas #[Route('/product-review', methods: ['POST'])] public function post( #[MapRequestPayload] ProductReviewDto $productReview, )

@nicolasgrekas class ProductReviewDto { public function __construct( #[Assert\NotBlank] #[Assert\Length(min: 10, max: 500)] public readonly string $comment, #[Assert\GreaterThanOrEqual(1)] #[Assert\LessThanOrEqual(5)] public readonly int $rating, ) { // ...

🛡️ Validation #[NoSuspiciousCharacters] #[NotCompromisedPassword] #[PasswordStrength] @nicolasgrekas

What's next? 💡 @nicolasgrekas

⛓ Contracts? #[Deprecated]? #[Internal]? #[Final]? @nicolasgrekas

🔧 Config? #[AutowireHttpClient(base_uri: etc.)]? @nicolasgrekas

Credits ♥ @nicolasgrekas

Hundreds of contributors @nicolasgrekas

Backers for 6.3 @nicolasgrekas symfony.com/sponsor

symfony.com/slack Mutual aid Kindness CARE team @nicolasgrekas

Thank you and see you soon! Online: