Migrer de Symfony 4 à Symfony 7

Avant de quitter Symfony 4.4

PHP minimum : 7.1.3

• BloquantLe composant Debug est déprécié au profit d'ErrorHandler : remplacer Symfony\Component\Debug\Debug par ErrorHandler\Debug.source
• BloquantCommand::execute() qui renvoie null est déprécié : retourner explicitement 0 (ou un code de sortie).source
• À traiterGuard : checkCredentials() doit renvoyer un booléen explicite (false pour des identifiants invalides).source
• À traiterExceptionEvent::getException()/setException() sont dépréciés au profit de getThrowable()/setThrowable().source
• MineurLe cache de métadonnées du Validator passe à PSR-6 : setMetadataCache() remplacé par setMappingCache().source
• MineurLock : StoreInterface est remplacée par BlockingStoreInterface et PersistingStoreInterface.source

Pièges rencontrés en migration

• Dernier palier LTS avant 5.0 : traiter toutes les dépréciations ici, car la 5.0 est la 4.4 sans compatibilité ascendante. Support de sécurité jusqu'en novembre 2023.source
• TemplateController ne supporte plus le moteur templating : tout rendu passe par Twig.source

Symfony 5 (5.0, 5.1, 5.2, 5.3 et 5.4)

PHP minimum : 7.2.5

• Bloquant · 5.0SimpleAuthenticatorInterface et ses variantes Form/PreAuthenticator sont supprimés : réécrire en authenticators Guard.source
• Bloquant · 5.0Controller et ContainerAwareCommand sont supprimés : étendre AbstractController et injecter les services dans les commandes.source
• Bloquant · 5.0La syntaxe de contrôleur bundle:controller:action n'est plus supportée : référencer les contrôleurs par FQCN::méthode.source
• Bloquant · 5.2Les services publics form.factory, form.type.file, translator et d'autres sont dépréciés : les injecter plutôt que les récupérer par le conteneur.source
• Bloquant · 5.3UserInterface::getUsername() est déprécié au profit de getUserIdentifier().source
• Bloquant · 5.3getPassword() sort de UserInterface : implémenter PasswordAuthenticatedUserInterface.source

Pièges rencontrés en migration

• Sans compatibilité ascendante : passer de 4.4 à 5.0 avec des dépréciations restantes casse la compilation du conteneur ; viser zéro dépréciation avant.source
• Version non LTS supportée jusqu'en juillet 2020 seulement : à traverser rapidement.source
• Les transports Messenger Doctrine/Redis/AMQP doivent être installés via leurs paquets dédiés (symfony/doctrine-messenger, etc.) : à ajouter dans composer.json.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

Étape intermédiaire, détaillée sur sa propre page : migration Symfony 5 → 6

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