Migrer de Symfony 6 à Symfony 8

Avant de quitter Symfony 6.4

PHP minimum : 8.1

• BloquantL'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
• BloquantSix défauts de config changent en 7.0 (http_method_override=false, handle_all_throwables=true, session.cookie_secure=auto, cookie_samesite=lax, UUID v7) : fixer les valeurs explicitement.source
• À traiterContainerAwareInterface et ContainerAwareTrait sont dépréciés : injecter les dépendances plutôt que le conteneur.source
• À traiterHeaderBag::getDate() et Response::getDate(), getExpires(), getLastModified() renvoient désormais un DateTimeImmutable (rupture de compatibilité).source
• À traiterLes services routing.loader.annotation* et AnnotatedRouteControllerLoader sont dépréciés au profit des équivalents attribute.source
• MineurDbalLogger et ContainerAwareLoader (fixtures) sont dépréciés : passer par un middleware DBAL et l'injection de dépendances.source

Pièges rencontrés en migration

• Le défaut de framework.http_method_override passe à false en 7.0 : les formulaires envoyant _method=PUT/DELETE cessent de fonctionner sans activation explicite.source
• Des return types natifs sont ajoutés à de nombreuses méthodes (Translator, Application::reset(), Logger::clear()) : les classes qui les surchargent doivent déclarer le type.source
• 6.4 est la version de préparation à la 7.0 : la 7.0 contient les mêmes fonctionnalités sans code déprécié, il faut donc résoudre toutes les dépréciations de la 6.4 avant de monter.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

Symfony 8 (8.0 et 8.1)

PHP minimum : 8.4

• Bloquant · 8.0Le format XML est abandonné : ExtensionInterface::getXsdValidationBasePath() et getNamespace() disparaissent, tout XML doit passer en YAML, PHP ou attributs.source
• Bloquant · 8.0Le format PHP fluide de configuration sémantique est supprimé : instancier le builder avec le tableau de config et le retourner.source
• Bloquant · 8.0Request::get() est supprimé : lire attributes, query ou request directement ; setFormat() n'accepte plus null.source
• Bloquant · 8.0UserInterface::eraseCredentials() et TokenInterface::eraseCredentials() sont supprimés : effacer les secrets via __serialize().source
• Bloquant · 8.1Les attributs de contrôleur (#[IsGranted], #[IsCsrfTokenValid], #[Cache]) sont traités à la priorité -10000 sur kernel.controller_arguments au lieu de 30-10.source
• À traiter · 8.0L'option hide_user_not_found est supprimée : seul expose_security_errors (enum ExposeSecurityLevel) est accepté.source

Pièges rencontrés en migration

• PHP 8.4 minimum : le saut PHP 8.2 vers 8.4 (voire 8.3) est le principal bloqueur ; mettre à jour image Docker, extensions et CI avant Symfony.source
• Le XML n'étant plus pris en charge, chaque bundle tiers doit publier une version compatible 8.0 : vérifier les dépendances avant la montée.source
• Version non-LTS arrêtée (fin 2026-07 selon symfony.com) : cible de passage vers la 8.1 ou rester sur 7.4 LTS.source

À lire sur le blog : De Symfony 7.4 LTS à la branche 8.x : éliminer les dépréciations proprement · Claude Craft #4 : Symfony 8.1, 126 commandes et 3 agents dédiés