Aller au contenu principal

Migration PHP · 8.2 → 8.3

Migrer de PHP 8.2 à PHP 8.3

PHP 8.2 reste couvert par les correctifs de sécurité jusqu’en décembre 2026 ; PHP 8.3 reste couvert par les correctifs de sécurité jusqu’en décembre 2027. Une seule version à franchir, documentée par le guide de migration 8.3 du manuel PHP. Première rupture à traiter : incrémenter ou décrémenter des chaînes vides ou non numériques est déprécié ; utiliser str_increment(). L'incrément de chaînes non numériques est soft-déprécié.

Où en est le support de PHP 8.2 et 8.3 ?

Support de PHP 8.2 et 8.3
CritèrePHP 8.2PHP 8.3
Sortiedécembre 2022novembre 2023
Fin des correctifs de bugsdécembre 2024décembre 2025
Fin des correctifs de sécuritédécembre 2026décembre 2027

Statuts vérifiés le 08/11/2026 sur les pages officielles de version.

Les ruptures à traiter en premier

  1. À traiter · 8.3Incrémenter ou décrémenter des chaînes vides ou non numériques est déprécié ; utiliser str_increment(). L'incrément de chaînes non numériques est soft-déprécié.source
  2. À traiter · 8.3range() durci : TypeError pour objets, tableaux et ressources, ValueError pour un pas à 0 ou négatif sur une plage croissante, avertissement pour une chaîne vide.source

Le chemin de migration, étape par étape

Chaque version mineure de PHP a son guide de migration officiel ; on les applique dans l’ordre, avec la CI au vert entre deux étapes. Avant de lancer le chantier, mesurer la dette avec un Bear Scan chiffre la dette qui ralentira chaque étape.

Passer à PHP 8.3

  • À traiterIncrémenter ou décrémenter des chaînes vides ou non numériques est déprécié ; utiliser str_increment(). L'incrément de chaînes non numériques est soft-déprécié.source
  • À traiterrange() durci : TypeError pour objets, tableaux et ressources, ValueError pour un pas à 0 ou négatif sur une plage croissante, avertissement pour une chaîne vide.source
  • À traiterAffecter un index négatif $n à un tableau vide fait désormais suivre $n+1 au lieu de 0.source
  • Mineurget_class() et get_parent_class() sans argument sont dépréciées ; assert_options() et les constantes ASSERT_* aussi.source
  • MineurUn programme proche du dépassement de pile peut désormais lever une Error (zend.max_allowed_stack_size, zend.reserved_stack_size).source

Extensions

  • Variante MT_RAND_PHP de Mt19937 dépréciée dans l'extension Random.source
  • mb_strimwidth() avec largeur négative et plusieurs API Phar, LDAP, SQLite3 et Zip sont dépréciées.source

Pièges rencontrés en migration

  • Le calcul de revalidation OPcache évolue : opcache_get_status()['scripts'][n]['revalidate'] contient maintenant un horodatage Unix, ce qui peut casser des outils de monitoring.source
  • Appeler proc_get_status() plusieurs fois renvoie maintenant toujours la bonne valeur (résultat mis en cache sur POSIX) ; la clé 'cached' permet de retrouver l'ancien comportement.source

Rector : LevelSetList::UP_TO_PHP_83

Guide officiel de migration vers PHP 8.3

À lire sur le blog : Migration PHP 8.1 vers 8.3 : les incompatibilités que personne ne mentionne · Docker multi-stage builds : image PHP 8.3 de 800 Mo à 80 Mo

Ce que PHP 8.3 vous apporte

  • 8.3 : Constantes de classe, d'interface, de trait et d'enum typées.source
  • 8.3 : Attribut #[\Override] qui vérifie qu'une méthode existe bien dans le parent ou l'interface implémentée.source
  • 8.3 : Accès dynamique aux constantes de classe avec C::{$name} et initialiseurs de variables statiques arbitraires.source
  • 8.3 : Réinitialisation des propriétés readonly dans __clone() et classes anonymes readonly.source
  • 8.3 : Syntaxe de repli pour les variables ini et closures créées depuis des méthodes magiques acceptant les arguments nommés.source

Combien coûte cette migration ?

À partir de 1 500 € HT

Pour une migration Bear Upgrade livrée en Merge Requests, Rector tourne d’abord en dry-run sur les transformations mécaniques, Claude Code traite les cas que Rector ne couvre pas, puis un développeur senior relit chaque Merge Request. Votre équipe veut reprendre la main ensuite ? Pensez à apprendre à piloter Claude Code sur votre code. Exemple concret : la migration Symfony d’un e-commerce bordelais, et après la migration, la maintenance des versions garde le socle à jour.

Questions fréquentes

Pour aller plus loin

Sources

Votre migration PHP 8.2 → 8.3, livrée en Merge Requests

CI au vert garantie 7 jours après le merge. Un appel de cadrage suffit pour fixer le périmètre, le prix et le délai.