Migration PHP 8.5 : montée de version sans risque

• PHP 8.4 → 8.5

  Migration courante

  Peu de BC breaks majeurs. Quelques dépréciations promues en erreurs et changements de comportement sur les extensions.

  • Opérateur Pipe (|>) : Nouvelle syntaxe →pas de BC break en soi, mais les projets qui utilisaient |> comme nom de variable ou dans des contextes non standards devront vérifier la compatibilité.
  • Extension URI : Ajout du namespace Uri\ : si votre projet définit des classes Uri dans le namespace global, des conflits de nommage peuvent apparaître.
  • array_first() / array_last() : Si votre projet définit des fonctions array_first() ou array_last() en global scope, elles entreront en conflit avec les nouvelles fonctions natives. Renommer ces fonctions avant de migrer.

• PHP 8.3 → 8.4

  Mineure

  Peu de BC breaks, principalement des dépréciations promues en erreurs.

  • Implicit nullable parameters dépréciés : function foo(int $x = null) est déprécié →utiliser ?int $x = null. PHP 9 en fera une erreur fatale. Rector corrige automatiquement.
  • GMP, PCNTL, POSIX : Plusieurs fonctions de ces extensions ont changé de signature. PHPStan et PHPUnit détectent les appels incompatibles.

• PHP 8.2 → 8.3

  Mineure

  Version principalement additive. Peu d'incompatibilités.

  • Typed class constants : Les constantes sans type dans les interfaces ou les classes abstraites peuvent lever des warnings si les classes filles ne respectent pas le contrat. Ajouter des types explicites est désormais recommandé.

• PHP 8.1 → 8.2

  Attention propriétés dynamiques

  PHP 8.2 déprécie la création dynamique de propriétés : une pratique courante dans les anciens projets qui génère des notices.

  • Dynamic properties dépréciées : $obj->dynamicProp = 'value' sur une classe sans cette propriété déclarée génère une notice E_DEPRECATED. En PHP 9, ce sera une erreur fatale. Ajouter les propriétés ou l'attribut #[AllowDynamicProperties].
  • ${var} string interpolation dépréciée : La syntaxe ${variable} dans les chaînes est dépréciée au profit de {$variable}. Rector corrige automatiquement l'ensemble du code.
  • Traits : propriétés constantes : Les traits ne peuvent plus définir de constantes →les déplacer dans la classe qui utilise le trait.

• PHP 8.0 → 8.1

  PHP 8.1

  PHP 8.1 renforce le typage et introduit des dépréciations sur le passage de null aux fonctions internes.

  • Passing null to non-nullable dépréciés : strlen(null), strtolower(null)… →passer null à une fonction qui attend string|int génère une dépréciation. En PHP 9, ce sera une TypeError. PHPStan niveau 6+ identifie tous ces appels.
  • Retour implicite null sur les fonctions void dépréciées : Les fonctions déclarées void qui retournent implicitement null émettent une dépréciation.
  • Valeurs de retour false pour les fonctions internes : Certaines fonctions qui retournaient false en cas d'échec lancent désormais une exception →à gérer explicitement.

• PHP 7.4 → 8.0

  Refonte typage

  PHP 8.0 est une version majeure avec une refonte de la gestion des avertissements et des comportements ambigus hérités de PHP 5.

  • Warnings → TypeError / ValueError : Des opérations qui produisaient un warning silencieux en PHP 7 (passage d'un mauvais type, division par zéro) lèvent désormais des exceptions. Les tests couvrent ces cas sinon ils se révèlent en production.
  • Comparaison de types non-stricte modifiée : 0 == 'foo' retourne false en PHP 8 (true en PHP 7). L'ensemble des comparaisons lâches entre int et string a été revu →à auditer soigneusement dans les projets anciens.
  • match() et named arguments : Pas de BC break, mais ces nouvelles syntaxes peuvent entrer en conflit avec des noms de fonctions internes ou des mots-clés mal utilisés.
  • Suppression de fonctions obsolètes : create_function(), each(), get_magic_quotes_*(), mbstring.func_overload supprimés. À remplacer avant la migration.

• PHP 5.x → 7.0

  BC break majeur

  Le saut le plus impactant de l'histoire de PHP. Zend Engine 3, suppression de fonctions entières, révision complète de la gestion des erreurs.

  • Extension mysql_* supprimée : mysql_connect(), mysql_query() et toute la famille mysql_* sont supprimées. Migrer vers PDO ou mysqli. C'est souvent le plus gros chantier sur les projets PHP 5 anciens.
  • Extension ereg supprimée : ereg(), eregi(), ereg_replace()… →remplacer par les équivalents preg_*(). Rector gère une partie des transformations mécaniques.
  • Erreurs fatales → Exceptions : Les erreurs internes du moteur PHP qui causaient une sortie abrupte lèvent désormais des exceptions Error récupérables. Cela change fondamentalement la gestion des erreurs →les catch(Exception) ne les capturaient pas avant.
  • Variables de variables dans les tableaux : $$array[key] est interprété différemment en PHP 7. Les expressions ambiguës doivent être rendues explicites avec des accolades.
  • Constructeurs PHP 4 supprimés : La méthode portant le nom de la classe comme constructeur (style PHP 4) n'est plus supportée. Remplacer par __construct().

• PHP 5.5 → 5.6

  Mineure

  Version additive avec peu de BC breaks. Principalement des dépréciations (mysql_*, mcrypt) annoncées avant PHP 7.

  • Dépréciation de mysql_* : Les fonctions mysql_* émettent des E_DEPRECATED dès PHP 5.5. C'est le signal qu'il faut migrer vers PDO avant PHP 7.

• PHP 5.4 → 5.5

  Mineure

  Introduction des générateurs et de finally. Peu de BC breaks.

  • Extension mysql dépréciée (officiel) : mysql_* passe en E_DEPRECATED official à partir de PHP 5.5 et sera supprimé en PHP 7.0.
  • Suppression de /e en preg_replace : L'option /e (exécution du remplacement comme code PHP) est supprimée →utiliser preg_replace_callback() à la place.

Source : Appendices de migration officiels sur php.net →liste non exhaustive, centrée sur les cas les plus fréquents en contexte applicatif.