Migration PHP 8.4 : la montée de version de vos applications PHP et Symfony

Cette page s'adresse à vous si une application de votre entreprise, un site, un back-office, un SaaS ou un outil métier, tourne sur une version de PHP que le projet PHP ne suivra plus en 2027. C'est souvent une application qui marche bien, qu'on a laissée en l'état parce que rien ne cassait, et dont l'équipe d'origine est partie.

Où en est votre version, d'après le calendrier de php.net :

Source : page des versions supportées de php.net, lue le 23/10/2026.

Le framework compte autant que PHP. Symfony 7.4, la version maintenue le plus longtemps aujourd'hui, demande au moins PHP 8.2 ; Symfony 8 demande PHP 8.4. Une application en Symfony 4 ou 5 sur PHP 7.4 a donc deux montées à mener, et l'ordre compte : c'est le sujet de notre démarche, plus bas.

Nous travaillons en Symfony et en PHP depuis plus de dix ans. Une montée de version suit chez nous le même ordre, quelle que soit la taille de l'application.

1. 1. Inventaire

   Version de PHP réellement servie en production (elle diffère parfois de celle de la ligne de commande), version du framework, bibliothèques et extensions, et compatibilité de chacune avec la version visée. La commande composer audit liste déjà les dépendances visées par un avis de sécurité.

2. 2. Des tests avant de toucher aux versions

   Nous regardons ce que les tests existants protègent vraiment. S'il en manque, nous en écrivons d'abord sur les parcours qui font rentrer de l'argent : commande, paiement, facturation.

3. 3. Le code que PHP refuse ou va refuser

   Chaque version a sa liste, publiée par php.net. PHP 8.0 a changé la comparaison entre une chaîne et un nombre et supprimé each() et create_function(). PHP 8.1 déprécie le passage de null aux fonctions natives qui ne l'attendent pas. PHP 8.2 déprécie les propriétés dynamiques, PHP 8.4 les paramètres implicitement nullables. Les outils d'analyse et de réécriture automatique traitent une bonne part de ces changements, le reste se corrige à la main.

4. 4. PHP et le framework, deux étapes séparées

   On ne monte pas PHP et Symfony le même jour. Une majeure de Symfony à la fois, en passant par la dernière mineure de chaque branche (5.4, 6.4, 7.4), les dépréciations traitées avant chaque saut. Chaque étape a son retour arrière prévu.

5. 5. Mise en production et suivi

   Préproduction identique à la production, recette sur vos parcours, bascule, puis surveillance des journaux d'erreurs les jours qui suivent.

La méthode de migration Symfony, version par version, et le calendrier des versions maintenues sont détaillés sur notre page agence Symfony.