Migrer de PHP 8.2 à PHP 8.5

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

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

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

Passer à PHP 8.5

• À traiterLes alias de casts non canoniques (boolean), (integer), (double) et (binary) sont dépréciés ; l'opérateur backtick est déprécié au profit de shell_exec().source
• À traiterUtiliser null comme index de tableau ou dans array_key_exists() est déprécié ; utiliser une chaîne vide.source
• À traiter__sleep() et __wakeup() sont soft-dépréciées au profit de __serialize()/__unserialize() ; register_argc_argv sur SAPI non CLI est déprécié.source
• À traiterNouveaux avertissements : cast d'un float hors plage vers int, cast de NAN, et déstructuration d'une valeur non tableau.source
• MineurLe réglage disable_classes est supprimé ; 'array' et 'callable' ne peuvent plus servir de nom d'alias dans class_alias().source

Extensions

• OPcache est toujours compilée dans le binaire et chargée ; opcache.enable et opcache.enable_cli restent honorés.source
• Nouvelle extension uri ; PDO::FETCH_CLASS suit désormais la sémantique de call_user_func_array() pour les arguments du constructeur.source

Pièges rencontrés en migration

• Un php.ini avec zend_extension=opcache.so ou php_opcache.dll émet maintenant un avertissement : retirer la ligne et conserver opcache.enable.source
• Le constructeur PDO::FETCH_CLASS suit la sémantique CUFA : les clés de chaîne deviennent des arguments nommés, et le wrapping automatique des arguments par valeur vers un paramètre par référence est supprimé.source

Rector : LevelSetList::UP_TO_PHP_85

Guide officiel de migration vers PHP 8.5

À lire sur le blog : PHP 8.5 en prod : array_first(), backtraces fatales et --ini=diff · PHP 8.5 `clone with` : Value Objects immutables sans boilerplate DDD