Migrer de Symfony 5 à Symfony 7

Avant de quitter Symfony 5.4

PHP minimum : 7.2.5

• BloquantIS_AUTHENTICATED_ANONYMOUSLY et IS_ANONYMOUS sont dépréciés : utiliser PUBLIC_ACCESS dans access_control.source
• BloquantisAnonymous() et is_anonymous() sont dépréciés, l'état anonyme disparaît en 6.0 : utiliser isAuthenticated() ou isFullFledged().source
• À traiterSecurityFactoryInterface est déprécié au profit de AuthenticatorFactoryInterface pour les factories de pare-feu personnalisées.source
• À traiterAuthenticatorInterface::createAuthenticatedToken() est déprécié au profit de createToken().source
• À traiterAuthenticationEvents::AUTHENTICATION_FAILURE est déprécié : écouter LoginFailureEvent.source
• À traiterLes tokens ne doivent plus contenir de credentials : Token::getCredentials() est déprécié.source

Pièges rencontrés en migration

• AbstractController::get(), has(), getDoctrine() et dispatchMessage() sont dépréciés : passer à l'injection de méthode ou de constructeur avant la 6.0.source
• Dernier palier LTS avant 6.0 (qui partage les mêmes nouveautés que la 5.4) : support de sécurité jusqu'en février 2029, mais plus de correctifs de bugs depuis novembre 2024.source

Symfony 6 (6.0, 6.1, 6.2, 6.3 et 6.4)

PHP minimum : 8.1

• Bloquant · 6.0Le composant Guard est supprimé : les authenticators doivent passer au système d'authentification (Passport, createToken() à la place de createAuthenticatedToken()).source
• Bloquant · 6.0UserInterface perd getPassword() et getSalt() : il faut implémenter PasswordAuthenticatedUserInterface (et la variante Legacy pour un sel utilisateur).source
• Bloquant · 6.0Les rôles IS_AUTHENTICATED_ANONYMOUSLY et IS_ANONYMOUS disparaissent : les règles access_control doivent utiliser PUBLIC_ACCESS.source
• Bloquant · 6.0AbstractController n'expose plus get(), has(), getDoctrine() ni dispatchMessage() : l'injection par constructeur ou par méthode devient obligatoire.source
• Bloquant · 6.2La classe et le service Symfony\Component\Security\Core\Security sont dépréciés : utiliser Symfony\Bundle\SecurityBundle\Security.source
• Bloquant · 6.4L'intégration de doctrine/annotations est dépréciée : migrer routes, validation et serializer vers les attributs natifs, avant la suppression en 7.0.source

Pièges rencontrés en migration

• PHP 8.0.2 minimum : la migration depuis 5.4 impose de monter PHP avant tout ; corriger d'abord toutes les dépréciations 5.4, car la 6.0 supprime ce que la 5.4 déprécie.source
• Request::getMasterRequest() et MASTER_REQUEST sont renommés en getMainRequest() et MAIN_REQUEST : un simple rechercher-remplacer évite des erreurs fatales dans les listeners.source
• Les propriétés publiques et protégées sont désormais considérées finales : surcharger une propriété d'une classe Symfony casse ; affecter sa valeur dans le constructeur.source

Symfony 7 (7.0, 7.1, 7.2, 7.3 et 7.4)

PHP minimum : 8.2

• Bloquant · 7.0L'intégration de doctrine/annotations est supprimée : routes, validation et serializer n'acceptent plus que les attributs PHP natifs.source
• Bloquant · 7.0Les options framework.validation.enable_annotations et serializer.enable_annotations disparaissent, remplacées par enable_attributes.source
• Bloquant · 7.0Command::$defaultName/$defaultDescription et ContainerAwareInterface/Trait sont supprimés : #[AsCommand] et injection de dépendances obligatoires.source
• Bloquant · 7.0MessageHandlerInterface et MessageSubscriberInterface sont retirés : tous les handlers Messenger doivent utiliser #[AsMessageHandler].source
• Bloquant · 7.3UserInterface::eraseCredentials() et TokenInterface::eraseCredentials() sont dépréciés : vider les secrets dans __serialize().source
• Bloquant · 7.4Le format de configuration XML est déprécié pour le conteneur et la validation : migrer vers YAML, PHP ou attributs avant la 8.0.source

Pièges rencontrés en migration

• PHP 8.2 devient le minimum : planifier la montée PHP (et Docker/CI) avant le passage en 7.0, qui est la vraie condition de blocage sur les hébergements anciens.source
• Symfony 7.0 ne lit plus les annotations (@Route, @Assert…) : routes et contraintes doivent être déclarées en attributs PHP (#[Route], #[Assert\NotBlank]) avant la montée.source
• Les nouveaux types natifs cassent les classes qui surchargent des méthodes Symfony sans return type : appliquer le patcher de types avant la montée.source

À lire sur le blog : De Symfony 7.4 LTS à la branche 8.x : éliminer les dépréciations proprement · Symfony 7.4 LTS : ce qu'il faut savoir avant de migrer