Aller au contenu principal

Migration PHP · 8.1 → 8.2 → 8.3

Migrer de PHP 8.1 à PHP 8.3

PHP 8.1 ne reçoit plus de correctifs de sécurité depuis décembre 2025 ; PHP 8.3 reste couvert par les correctifs de sécurité jusqu’en décembre 2027. La montée traverse 2 versions (8.2 et 8.3), chacune avec ses incompatibilités documentées dans le manuel PHP. 1 rupture à fort impact sur le parcours. Première rupture à traiter : la création de propriétés dynamiques est dépréciée, sauf avec #[\AllowDynamicProperties] ; stdClass reste autorisée. Impact fort sur les entités et DTO hérités.

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

Support de PHP 8.1 et 8.3
CritèrePHP 8.1PHP 8.3
Sortienovembre 2021novembre 2023
Fin des correctifs de bugsnovembre 2023décembre 2025
Fin des correctifs de sécuritédécembre 2025décembre 2027

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

Les ruptures à traiter en premier

  1. Bloquant · 8.2La création de propriétés dynamiques est dépréciée, sauf avec #[\AllowDynamicProperties] ; stdClass reste autorisée. Impact fort sur les entités et DTO hérités.source
  2. À traiter · 8.2L'interpolation "${var}" et "${expr}" est dépréciée : utiliser "$var" ou "{$var}".source
  3. À 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

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, auditer la dette technique avec Bear Scan chiffre la dette qui ralentira chaque étape.

Passer à PHP 8.2

  • BloquantLa création de propriétés dynamiques est dépréciée, sauf avec #[\AllowDynamicProperties] ; stdClass reste autorisée. Impact fort sur les entités et DTO hérités.source
  • À traiterL'interpolation "${var}" et "${expr}" est dépréciée : utiliser "$var" ou "{$var}".source
  • À traiterCallables relatifs ("self::method", ["parent", "method"]) dépréciés quand $callable() ne les accepte pas.source
  • À traiterutf8_encode() et utf8_decode() sont dépréciées ; les encodages mbstring HTML-ENTITIES, Base64, QPrint et Uuencode aussi.source
  • Mineurglob() renvoie un tableau vide, et non false, si open_basedir restreint tous les chemins ; FilesystemIterator::SKIP_DOTS n'est plus forcé.source

Extensions

  • Nouvelle extension Random ; ODBC, PDO_ODBC, OCI8, cURL et OpenSSL reçoivent des ajustements.source
  • Les méthodes DateTime::createFromImmutable() et DateTimeImmutable::createFromMutable() ont un type de retour tentatif static.source

Pièges rencontrés en migration

  • Les dépréciations de propriétés dynamiques apparaissent à l'exécution, pas à la compilation : couvrir les chemins rares (cron, hydratation, tests) avant la mise en production.source
  • Plusieurs bibliothèques anciennes encodent en UTF-8 via utf8_encode() : un grep dans vendor/ évite des centaines de dépréciations.source

Rector : LevelSetList::UP_TO_PHP_82

Guide officiel de migration vers PHP 8.2

À lire sur le blog : PHP 8.6 arrive le 19 novembre, PHP 8.2 expire le 31 décembre

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 la migration accompagnée Bear Upgrade, 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 à former votre équipe à Claude 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.1 → 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.