Et si la montée de version de PHP n'était plus un saut dans le vide ?
Dans beaucoup de projets hérités, la même question revient dès le premier jour : sur quelle version de PHP tourne la production ? La réponse est souvent 7.2 ou 7.4, parfois 5.6, sur un serveur que personne n'ose toucher. Or PHP 7.4 a atteint sa fin de vie en novembre 2022, et PHP 8.0 a suivi un an plus tard. Ces applications ne reçoivent plus de correctifs de sécurité et bloquent l'installation de la plupart des paquets récents.
L'équipe le sait, mais le chantier est repoussé de trimestre en trimestre, parce qu'il ressemble à un grand saut risqué. Il peut pourtant se découper en une série de petites pull requests, chacune testée et déployable. C'est l'approche décrite dans Upgrading Old PHP Versions Safely With Rector and CI, dont nous tirons ici une méthode applicable à vos projets PHP et Symfony.
Le principe : trois outils qui se complètent
La migration repose sur un trio, chacun avec un rôle précis.
- Rector réécrit automatiquement le code pour le rendre compatible avec la version cible : syntaxe dépréciée, fonctions retirées, nouvelles écritures du langage.
- PHPStan analyse le code sans l'exécuter et signale les erreurs de types, les appels incohérents et les zones fragiles que la réécriture automatique ne peut pas deviner.
- L'intégration continue (CI) rejoue tout cela à chaque modification, avec les tests, pour qu'aucune régression ne passe inaperçue.
Aucun de ces outils ne suffit seul. Rector produit des changements en masse, PHPStan vérifie leur cohérence, et la CI joue le rôle de filet de sécurité permanent.
Une méthode en petites étapes
1. Poser le filet avant de toucher au code
Avant toute transformation, il faut un point de référence. Faites tourner la suite de tests existante dans la CI sur la version actuelle, et lancez PHPStan à un niveau bas pour établir un état des lieux. Si le projet manque de tests, quelques tests de caractérisation sur les parcours critiques valent mieux que rien : ils figent le comportement actuel.
2. Lancer Rector sur une branche dédiée
Créez une branche de test et activez les ensembles de règles correspondant à la version visée, un palier à la fois. Passer de 7.4 à 8.0, puis de 8.0 à 8.1, est plus sûr que de viser directement la version la plus récente. Chaque palier donne un diff relisible, que l'on peut découper par répertoire ou par type de règle.
Un exemple minimal de configuration :
use Rector\Config\RectorConfig;
use Rector\Set\ValueObject\LevelSetList;
return static function (RectorConfig $rectorConfig): void {
$rectorConfig->paths([__DIR__ . '/src', __DIR__ . '/tests']);
$rectorConfig->sets([LevelSetList::UP_TO_PHP_80]);
};
La commande vendor/bin/rector process --dry-run permet de visualiser les changements avant de les appliquer.
3. Resserrer PHPStan progressivement
Une fois le code réécrit, montez le niveau de PHPStan par étapes. Les erreurs révélées sont souvent de vrais bogues dormants : propriétés non initialisées, retours incohérents, comparaisons laxistes dont le comportement change avec PHP 8. Une baseline permet d'accepter la dette existante tout en bloquant toute nouvelle erreur.
4. Faire de la CI le garde-fou
La CI doit exécuter les tests, PHPStan et Rector en mode simulation sur chaque pull request. Une matrice avec plusieurs versions de PHP permet de vérifier que le code fonctionne à la fois sur la version actuelle et sur la version cible pendant la transition. Si Rector propose encore des changements, la CI échoue : le code ne peut pas régresser vers d'anciennes écritures.
5. Déployer palier par palier
Chaque palier doit pouvoir partir en production seul. Un incident se traite alors sur un périmètre réduit, avec un retour arrière simple. C'est la grande différence avec une migration menée comme un chantier unique de plusieurs semaines.
Points de vigilance
- Les dépendances Composer doivent être mises à jour en parallèle : certaines n'existent plus pour les versions anciennes, d'autres ne supportent pas encore la version cible.
- Rector ne remplace pas la relecture : certaines transformations changent subtilement la sémantique et méritent un regard humain.
- Les extensions PHP du serveur et la configuration d'exécution doivent être alignées avec l'environnement de CI, sinon les tests ne reflètent pas la production.
- Sur un très gros monolithe, mieux vaut migrer module par module que tout traiter d'un bloc.
Conclusion
Mettre à jour une vieille version de PHP n'est pas un projet de réécriture. Avec Rector pour automatiser les corrections, PHPStan pour révéler les fragilités et une CI exigeante pour verrouiller chaque acquis, le chantier devient une suite de changements modestes et vérifiables. Le plus dur est souvent de commencer : une branche de test et une première exécution de Rector en simulation suffisent pour mesurer l'ampleur réelle du travail et en finir avec l'inconnu.
L'article d'origine complète cette approche avec une stratégie de cohabitation entre ancien et nouveau code, à lire pour les projets où la migration doit se faire sans interruption de service.
Et votre site, il vaut quoi ?
Vitesse, accessibilité, référencement technique. Le rapport est écrit pour un dirigeant, pas pour un développeur. Gratuit, sans inscription.