Migrer de Symfony 3 à Symfony 6

Avant de quitter Symfony 3.4

PHP minimum : 5.5.9

• BloquantServices et alias seront privés par défaut en 4.0 : ne plus appeler $container->get() ; injecter les dépendances ou marquer public: true.source
• BloquantL'auto-enregistrement de services lié à l'autowiring est déprécié : déclarer explicitement les services, ids égaux aux FQCN.source
• À traiterNe pas fixer strict=true sur la contrainte Choice est déprécié : l'ajouter partout où la contrainte est utilisée.source
• À traiterYaml::PARSE_KEYS_AS_STRINGS est déprécié : mettre entre guillemets les clés numériques et booléennes dans les fichiers YAML.source
• MineurLes syntaxes !php/object: et !php/const: avec deux-points sont dépréciées au profit de !php/object et !php/const.source
• MineurLa classe ProcessBuilder est dépréciée : instancier directement Process avec un tableau d'arguments.source

Pièges rencontrés en migration

• La 3.4 est le palier obligé avant 4.0 : activer le logging des dépréciations et les traiter toutes sur cette version, puisqu'elles deviennent des erreurs en 4.0.source
• Les contrôleurs et commandes qui récupèrent leurs services via le conteneur (container->get) casseront au passage en 4.0 : les convertir en injection par constructeur.source

Symfony 4 (4.0, 4.1, 4.2, 4.3 et 4.4)

PHP minimum : 7.1.3

• Bloquant · 4.0Les services sont privés par défaut : Container::get() sur un service privé n'est plus supporté.source
• Bloquant · 4.0L'autowiring par type implémenté est supprimé : il faut un alias ou un id de service égal au FQCN.source
• Bloquant · 4.0La découverte des commandes par convention (Command/ dans les bundles) est supprimée : les enregistrer comme services tagués.source
• Bloquant · 4.1Les syntaxes de contrôleur bundle:controller:action et service:action sont dépréciées : utiliser serviceOrFqcn::method.source
• Bloquant · 4.2La classe Controller de FrameworkBundle est dépréciée : étendre AbstractController (services non accessibles via le conteneur).source
• Bloquant · 4.3La signature d'EventDispatcherInterface::dispatch() s'inverse : dispatch($event, $eventName) au lieu de dispatch($eventName, $event).source

Pièges rencontrés en migration

• Adopter Symfony Flex impose de déplacer app/, web/ et var/ vers la nouvelle structure (config/, public/, templates/) ; la recette de migration est la partie la plus longue du passage.source
• Les clés YAML non chaînes (true:, null:) sont rejetées : auditer les fichiers de configuration.source
• Les références de contrôleurs à l'ancienne (AppBundle:Default:index) dans routing.yml et les annotations sont à convertir en FQCN avant la 5.0.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

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

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