Migrer de PHP 8.1 à PHP 8.4

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

Étape intermédiaire, détaillée sur sa propre page : migration PHP 8.2 → 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

Passer à PHP 8.4

• BloquantParamètre implicitement nullable (Type $p = null) déprécié : écrire ?Type ou Type|null. Touche massivement le code hérité et les dépendances.source
• À traiterexit() et die() se comportent comme des fonctions : soumis à strict_types et lèvent TypeError pour un type invalide.source
• À traiterLe niveau E_STRICT est supprimé et sa constante déclarée dépréciée ; trigger_error() avec E_USER_ERROR est déprécié.source
• À traiterModification indirecte de propriétés readonly dans __clone() interdite ; la récursion pendant une comparaison lève une Error.source
• Mineurround() lève ValueError pour un mode invalide, str_getcsv() exige des séparateurs d'un octet, et nommer une classe _ est déprécié.source

Extensions

• Migration ressource vers objet pour DBA, ODBC et SOAP.source
• opcache.interned_strings_buffer : maximum relevé à 32767 sur 64 bits (4095 avant) ; nouveaux avertissements ou exceptions dans curl, gd, intl, mbstring, session, xml.source

Pièges rencontrés en migration

• Les dépréciations de types implicitement nullables viennent surtout des dépendances : mettre à jour les paquets de vendor/ (composer outdated) avant de basculer la production.source
• Une API qui passait n'importe quel type à exit() (ex. un tableau ou un objet) échoue désormais en TypeError dans les scripts et commandes console.source

Rector : LevelSetList::UP_TO_PHP_84

Guide officiel de migration vers PHP 8.4

À lire sur le blog : Doctrine ORM 3.4.0 : Lazy Objects natifs PHP 8.4 en production · Docker PHP 8.4 production : multi-stage, non-root et scan Trivy en CI