Migrer de Symfony 2 à Symfony 6

Avant de quitter Symfony 2.8

PHP minimum : 5.3.9

• BloquantFormTypeInterface::getName() est déprécié : il faut passer à getBlockPrefix() ou aux noms de classe (FQCN) pour les types de formulaire.source
• À traiterL'option cascade_validation des formulaires est dépréciée au profit de l'option constraints avec la contrainte Valid.source
• À traiterLes scopes du conteneur (Definition::setScope(), ContainerBuilder::getScopes()) sont dépréciés ; le nouveau drapeau shared les remplace.source
• À traiterAbstractVoter est déprécié : les voters doivent étendre la classe Voter.source
• MineurLe paramètre session.cookie_httponly vaut désormais true par défaut : à vérifier si du JavaScript lit le cookie de session.source

Pièges rencontrés en migration

• La 2.8 sert de palier de nettoyage : tout ce qu'elle déprécie est supprimé en 3.0. Corriger les dépréciations (formulaires, scopes, voters) avant de monter.source

Symfony 3 (3.0, 3.1, 3.2, 3.3 et 3.4)

PHP minimum : 5.5.9

• Bloquant · 3.0Le composant Locale est supprimé : migrer vers Intl (par exemple Intl::getLanguageBundle()).source
• Bloquant · 3.0Form::bind() et isBound() sont supprimées : utiliser submit(), isSubmitted() ou handleRequest().source
• Bloquant · 3.0Le service request est supprimé : injecter request_stack et appeler getCurrentRequest().source
• Bloquant · 3.2Appeler isValid() sur un formulaire non soumis est déprécié : écrire isSubmitted() && isValid().source
• Bloquant · 3.2doctrine/annotations n'est plus une dépendance directe de FrameworkBundle : l'ajouter explicitement dans composer.json si vous utilisez des annotations.source
• Bloquant · 3.3L'autowiring par types implémentés est déprécié (retiré en 4.0) : déclarer des alias ou nommer les services par FQCN.source

Pièges rencontrés en migration

• Aucune couche de compatibilité : passer de 2.8 à 3.0 sans avoir éliminé toutes les dépréciations casse le code immédiatement. Les logs de dépréciation de la 2.8 sont le point de départ.source
• Les routes en YAML ou annotations utilisant pattern, _method ou _scheme doivent toutes être réécrites.source
• Version non LTS maintenue environ 14 mois : ne pas s'y arrêter, c'est un simple pas vers la 3.4 LTS.source

À lire sur le blog : Sécuriser votre app Symfony en 30 minutes : checklist OWASP

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

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

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