Migrer de PHP 5.6 à PHP 8.4

Passer à PHP 7.0

• BloquantBeaucoup d'erreurs fatales deviennent des exceptions Error ; un set_exception_handler() typé Exception provoque une erreur fatale si une Error est levée.source
• BloquantRetrait de toutes les fonctions ext/mysql (mysql_*) : il faut migrer vers mysqli ou PDO.source
• BloquantRetrait des fonctions ereg* (remplacées par PCRE) et de preg_replace() avec le modificateur /e, à remplacer par preg_replace_callback().source
• À traiterLes erreurs de syntaxe lèvent ParseError : tout eval() doit gérer cette exception.source
• À traiterL'évaluation des variables indirectes passe en strict gauche-droite : $$foo['bar']['baz'] devient ($$foo)['bar']['baz'], à corriger avec des accolades.source

Extensions

• Extensions retirées : ereg, mssql, mysql et sybase_ct ; SAPI Apache 1 (apache, apache_hooks) et plusieurs SAPI obsolètes supprimés.source
• L'extension JSON est remplacée par JSOND : un nombre ne peut plus finir par un point (34.) et une chaîne vide n'est plus du JSON valide.source

Pièges rencontrés en migration

• foreach par valeur travaille sur une copie du tableau : les modifications faites pendant l'itération ne sont plus vues, ce qui change le comportement de boucles qui ajoutaient des éléments.source
• list() assigne désormais dans l'ordre de déclaration : list($a[], $a[], $a[]) inverse son résultat par rapport à PHP 5.source

Rector : LevelSetList::UP_TO_PHP_70

Guide officiel de migration vers PHP 7.0

Passer à PHP 7.1

• BloquantAppeler une fonction utilisateur avec trop peu d'arguments lève désormais ArgumentCountError (Error) au lieu d'un simple avertissement.source

Étape intermédiaire, détaillée sur sa propre page : migration PHP 7.0 → 7.1

Passer à PHP 7.2

• Bloquantcount() sur une valeur non dénombrable (null, scalaire, objet non Countable) émet un E_WARNING ; très fréquent dans le code hérité de PHP 5.source
• Bloquanteach() est dépréciée : à remplacer par foreach ou ArrayIterator.source

Étape intermédiaire, détaillée sur sa propre page : migration PHP 7.1 → 7.2

Passer à PHP 7.3

• À traiterAvec le heredoc flexible, un marqueur de fin apparaissant dans le corps (même indenté) termine la chaîne et peut provoquer une erreur de syntaxe.source
• À traitercontinue ciblant un switch émet un avertissement : il se comporte comme break, alors que d'autres langages le traitent comme continue 2.source

Étape intermédiaire, détaillée sur sa propre page : migration PHP 7.2 → 7.3

Passer à PHP 7.4

• À traiterAccéder à null, bool, int, float ou resource comme à un tableau ($null['key']) génère désormais une notice.source
• À traiterfn devient un mot réservé : il ne peut plus nommer une fonction ou une classe (reste possible pour une méthode ou une constante de classe).source

Étape intermédiaire, détaillée sur sa propre page : migration PHP 7.3 → 7.4

Passer à PHP 8.0

• BloquantComparaison lâche nombre/chaîne non numérique : on compare désormais en chaîne, donc 0 == 'foo' vaut false. Fait sauter beaucoup de conditions legacy.source
• BloquantL'opérateur @ ne masque plus les erreurs fatales ; error_reporting par défaut passe à E_ALL et display_startup_errors est activé.source

Étape intermédiaire, détaillée sur sa propre page : migration PHP 7.4 → 8.0

Passer à PHP 8.1

• BloquantPasser null à un paramètre non nullable d'une fonction interne est déprécié (strlen(null), trim(null)…) : source massive d'avertissements.source
• BloquantLes méthodes internes non finales exigent un type de retour compatible dans les classes filles ; sinon dépréciation, masquable par #[\ReturnTypeWillChange].source

Étape intermédiaire, détaillée sur sa propre page : migration PHP 8.0 → 8.1

À lire sur le blog : Migration PHP 8.1 vers 8.3 : les incompatibilités que personne ne mentionne

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

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