Skip to content
PrestaShop

Migrer vers PHP 8.4 et Symfony 6.4 : liste de contrôle rapide

23 février 2026
Alexandre
7 min. de lecture
Migrer vers PHP 8.4 et Symfony 6.4 : liste de contrôle rapide

Migrer vers PHP 8.4 et Symfony 6.4 (ou préparer la trajectoire vers Symfony 7.4/8.0) n’est pas qu’une question de mise à jour Composer : c’est un enchaînement de prérequis runtime, de nettoyage de dépréciations, de synchronisation de configuration et de discipline CI.

Cette liste de contrôle rapide vise à réduire les risques classiques (ruptures à l’exécution, configuration “driftée”, extensions manquantes sur la plateforme) et à vous aider à planifier avec les fenêtres de support, en particulier si vous avez des contraintes d’audit/compliance.

1) Verrouiller votre calendrier : support Symfony 6.4 LTS et contraintes 2026, 2027

Symfony 6.4 est une LTS : elle reçoit des correctifs de bugs jusqu’au 30/11/2026 et des correctifs de sécurité jusqu’au 30/11/2027. En 2026, la checklist la plus “rentable” consiste souvent à aligner votre planning de migration sur ces dates pour éviter une zone grise de support.

Si vous êtes soumis à des audits (ISO, SOC2, exigences client, réglementation), la date de fin de support sécurité est généralement un jalon non négociable. Planifiez une bascule (ou au minimum une trajectoire validée) avant novembre 2027, en tenant compte des cycles de recette et de déploiement.

En parallèle, imposez une cadence de patching pendant la migration : suivre les versions 6.4.x (par exemple des releases comme 6.4.29 qui peuvent inclure des correctifs de sécurité, notamment sur HttpFoundation avec un CVE) évite de “geler” une base vulnérable le temps du chantier.

2) Vérifier la branche réellement maintenue et choisir une cible (6.4 / 7.4 LTS / 8.0)

Avant de toucher au code, vérifiez quelle branche Symfony est activement maintenue et quelle version Symfony recommande à l’instant T. L’objectif est de ne pas investir des semaines sur une cible qui n’a plus le bon niveau de support ou qui vous force ensuite à un nouvel upgrade immédiat.

Décidez explicitement votre cible : rester en 6.4 LTS (stabilité), monter vers 7.4 LTS (trajectoire progressive), ou viser 8.0 (modernisation rapide). Cette décision conditionne l’ordre des opérations, le niveau de refactoring et les prérequis PHP.

Prenez aussi en compte la recommandation de méthodologie souvent reprise (ex. SymfonyInsight) : 1) monter au dernier mineur (ici 6.4 au plus haut patch), 2) corriger les dépréciations, 3) migrer vers la majeure suivante. Cela évite les upgrades “au hasard” qui multiplient les points de rupture.

3) Cadrer le “pourquoi” et l’ordre des chantiers : Symfony 8.0 impose PHP ≥ 8.4

Point structurant : Symfony 8.0 requiert PHP ≥ 8.4.0. Donc si votre feuille de route vise Symfony 8.x, la migration PHP n’est pas optionnelle et doit être planifiée comme un prérequis runtime (infrastructure, images Docker, PaaS, extensions, CI).

À l’inverse, si votre priorité est de sécuriser et stabiliser sans changer de majeure immédiatement, rester en Symfony 6.4 LTS peut être une décision rationnelle : la sécurité est assurée jusqu’en novembre 2027, ce qui peut laisser le temps de préparer proprement PHP 8.4 et les dépréciations applicatives.

Dans tous les cas, formalisez un ordre de passage : environnement (PHP/OS/extensions) → dépendances (Composer) → compatibilité (dépréciations) → code applicatif → déploiement. C’est la meilleure façon de réduire les “surprises” en production.

4) Stratégie Symfony “future compatible” : traquer et supprimer les dépréciations d’abord

Symfony recommande une approche explicite pour les upgrades : (1) rendre le code sans dépréciations, (2) upgrader via Composer, (3) adapter le code. En pratique, cela signifie que la chasse aux dépréciations est un chantier à part entière, pas un effet secondaire.

Une idée clé pour construire une trajectoire fiable : “Symfony 8.0 = Symfony 7.4 , deprecations”. Autrement dit, passer par 7.4 permet de voir (et éliminer) les dépréciations qui deviendront des erreurs en 8.0.

Le plan d’attaque recommandé pour viser Symfony 8.0 est donc séquentiel : 1) upgrade vers 7.4, 2) détecter les dépréciations, 3) corriger, 4) upgrade vers 8.0. C’est plus long sur le papier, mais nettement moins risqué que de sauter des étapes.

5) Mettre les dépréciations sous contrôle via les tests et la CI (PHPUnit + PHPUnit Bridge)

Mesurez les dépréciations via vos tests : exécuter PHPUnit avec un affichage des dépréciations permet de les traiter systématiquement, au lieu de les découvrir tardivement dans les logs. Une migration réussie se pilote avec des métriques, pas au ressenti.

Pour industrialiser, activez un rapport de dépréciations sur la CI via Symfony PHPUnit Bridge. La documentation Symfony montre l’installation de symfony/phpunit-bridge pour obtenir un résumé des dépréciations en fin d’exécution, ce qui facilite le tri et le suivi.

En contexte “fail on deprecations” (fréquent en CI), cette étape évite que PHP 8.4 + dépendances récentes fassent échouer vos pipelines sans explication exploitable. Le but est d’avoir une liste finie, assignable, et de la faire décroître sprint après sprint.

6) Éviter le drift de configuration : mettre à jour les recipes Symfony Flex

Lors des migrations, un piège courant est le décalage entre votre code et les fichiers générés/attendus par les recipes (configuration, scripts, fichiers de base). Même si le code compile, la configuration peut devenir incohérente à force de mises à jour.

Ajoutez à la checklist l’étape : mettre à jour les recipes Symfony Flex avec composer recipes:update (Flex ≥ 1.18). C’est souvent “oublié”, alors que c’est une source classique de bugs subtils (paramètres déplacés, nouveaux fichiers, changements de conventions).

Faites-le de manière contrôlée : exécutez la commande sur une branche dédiée, relisez les diffs, et validez par tests. L’objectif est de synchroniser la configuration avec l’état actuel de l’écosystème, pas d’accepter aveuglément tout changement.

7) Préparer les ruptures majeures : lire les UPGRADE- et corriger les signatures (native return types)

Avant toute bascule majeure, Symfony recommande explicitement de lire les fichiers UPGRADE-X.0.md. Ils listent les BC breaks, les changements de comportement et les actions nécessaires : c’est votre “contrat” de migration.

Une source classique d’erreurs au passage de majeures : les déclarations incompatibles (notamment avec l’introduction/renforcement de types). Symfony documente la préparation attendue, dont l’ajout de native return types en amont pour réduire les erreurs du style “incompatible declaration”.

Pour automatiser, utilisez l’outil officiel ./vendor/bin/patch-type-declarations. Il peut être piloté via SYMFONY_PATCH_TYPE_DECLARATIONS pour ajuster le comportement. Intégrez cette étape tôt, idéalement avant de verrouiller une branche de release.

8) Checklist PHP 8.4 : extensions, dépréciations, et changements de comportement à tester

PHP 8.4 introduit des changements de packaging : certaines extensions sont désormais “unbundled” (IMAP, OCI8, PDO_OCI, pspell). Concrètement : vérifiez votre php.ini, vos images Docker, et votre pipeline (installation via PECL potentiellement requise) avant même de lancer une migration applicative.

Côté langage/runtime, traquez les nouvelles dépréciations : “Implicitly nullable parameter types are now deprecated”. Scannez et corrigez les signatures (ex. paramètres typés sans ?Type mais avec valeur par défaut null), sinon vous accumulerez des warnings , et en CI stricte, des échecs.

Testez aussi les ruptures comportementales : round avec un mode invalide lève désormais ValueError (ajoutez des tests ou des guard clauses), stream_bucket_make_writeable/stream_bucket_new retournent désormais un StreamBucket (plus stdClass), certaines extensions introduisent des constantes typées (date/intl/pdo/reflection/spl/sqlite/xmlreader), GMP devient final (attention héritage/mocks), et mysqli supprime/déprécie plusieurs constantes/fonctions (mysqli_ping, mysqli_kill, mysqli_refresh). Enfin, E_STRICT est dépréciée : nettoyez error_reporting et le legacy qui s’y accroche.

9) Hébergement / PaaS : valider PHP 8.4, la liste d’extensions et la maturité plateforme

Une migration PHP échoue souvent non pas sur le code, mais sur la disponibilité des extensions et la maturité des images côté hébergeur. Faites une checklist “plateforme” : version exacte de PHP 8.4, extensions nécessaires, paramètres INI, et limitations (buildpacks, compilation, PECL autorisé ou non).

Exemple de pratique utile : certains PaaS communiquent explicitement leur support (par ex. annonce de PHP 8.4.3 et liste d’extensions disponibles). Utilisez ces informations pour valider rapidement votre compatibilité , ou décider d’un plan alternatif (container custom, changement d’offre, etc.).

Vérifiez aussi la cohérence entre environnements : dev/staging/prod doivent partager la même “surface” (mêmes extensions, mêmes flags de compilation, mêmes INI). Sans cela, vous risquez des bugs qui n’apparaissent qu’en production, notamment sur streams/filters, intl, pdo, ou des comportements d’erreurs.

Une migration maîtrisée vers PHP 8.4 et Symfony repose sur trois piliers : un planning aligné sur le support (6.4 LTS jusqu’à fin 2027 côté sécurité), une trajectoire Symfony sans dépréciations (future compatible), et une validation infra (extensions + PaaS) avant le refactoring.

En pratique, transformez cette liste en tâches CI et en critères d’acceptation : rapport de dépréciations, mise à jour des recipes Flex, lecture des UPGRADE-.md, correction de signatures/types, et exécution de la suite de tests sur un runtime PHP 8.4 identique à la prod. C’est ce qui permet d’avancer vite, sans multiplier les retours arrière.

Partager cet article