Web et développement

PHP 8.6 : Nouvelles fonctionnalités, fonctions dépréciées et un guide de migration pratique

PHP 8.6: New Features, Deprecated Functions, and a Practical Migration Guide

Mettez à niveau vers PHP 8.6 avec des exemples avant/après pour les fonctions PHP dépréciées, MySQLi, mbstring, CSV, sessions et une liste de vérification de migration pratique.

PHP 8.6.0 est sorti le 19 novembre 2026. Les fonctionnalités phares sont intéressantes, mais pour les développeurs qui maintiennent de véritables sites web, la question urgente est souvent différente : quelles lignes de code existantes vont commencer à émettre des avis de dépréciation, et comment faut-il les réécrire ?

Ce guide place le travail de migration au premier plan. Chaque exemple identifie une API dépréciée, montre un remplacement et met en évidence les cas où une recherche-remplacement mécanique serait dangereuse. Un avis de dépréciation n'est pas la même chose qu'une erreur fatale immédiate : il avertit qu'un code a besoin d'attention, souvent avant qu'une future version majeure ne supprime l'API.

Voie de migration vers PHP 8.6 : inventaire, préproduction, journaux, corrections et tests de non-régression

1. Vérifiez votre runtime avant de toucher à la production

Exécutez ces commandes dans le même environnement PHP que celui qui sert l'application (le PHP en ligne de commande et le PHP web peuvent utiliser des binaires et des paramètres différents) :

php -v
php -m
php --ini

Vérifiez les extensions utilisées par le projet, en particulier mbstring, mysqli et intl. Assurez-vous que le framework, le CMS, les extensions et l'environnement d'hébergement prennent explicitement en charge PHP 8.6 ; ne déduisez pas la compatibilité du seul fait qu'un site démarre.

Dans un environnement de préproduction, enregistrez toutes les erreurs dans un journal tout en gardant les messages de diagnostic hors du HTML public :

<?php
error_reporting(E_ALL);
ini_set('log_errors', '1');
ini_set('display_errors', '0');

Ces paramètres d'exécution sont utiles pour un test contrôlé. Pour les environnements de longue durée, préférez configurer la journalisation au niveau du serveur ; assurez-vous que le journal des erreurs est accessible en écriture et privé. Un message Deprecated est exploitable même lorsque la page continue de s'afficher.

2. Aide-mémoire : API dépréciées et alternatives à utiliser

Déprécié en PHP 8.6 Approche recommandée Point d'attention pour la migration
is_integer(), is_long() is_int() Alias directs
is_double() is_float() Alias direct
doubleval() floatval() Alias direct
spl_object_hash() spl_object_id() Le type de retour passe de string à int
mb_ereg(), mb_eregi() preg_match() Adapter la syntaxe du motif et les options Unicode
mb_ereg_replace() preg_replace() Vérifier l'échappement, la sémantique du remplacement et les erreurs
mysqli_stmt_init() mysqli_prepare() À préparer dès maintenant
mysqli_get_charset() mysqli_character_set_name() Uniquement si le nom du jeu de caractères est nécessaire
SplFileObject::fgetcsv() fgetcsv() sur un flux Revoir la position dans le flux et les paramètres CSV
SplFileObject::fputcsv() fputcsv() sur un flux Passer explicitement le séparateur, le caractère de délimitation et le caractère d'échappement
strcoll() Collator::compare() Nécessite intl ; choisir une locale
SORT_LOCALE_STRING Collator::sort() / asort() Le comportement lié à la locale peut changer
spl_classes() ReflectionExtension::getClassNames() Examiner l'extension appropriée
Troisième argument de define() Omettre l'argument L'ancien mode insensible à la casse a disparu
return dans finally Retour à l'extérieur de finally Éviter de supprimer les exceptions
Objet passé à array_walk() get_object_vars() au préalable Les modifications par référence peuvent ne plus affecter l'objet
metaphone() Une implémentation phonétique maintenue Aucun remplacement natif équivalent dans le cœur de PHP

Certaines API n'ont aucun remplacement exact. La bonne migration peut nécessiter de revoir la conception plutôt que de renommer une fonction. Voir la liste officielle des dépréciations de PHP 8.6.

3. Alias simples : corrections sûres et rapides

Avant — déprécié :

<?php
if (is_integer($quantity) && is_double($price)) {
    $total = doubleval($price) * $quantity;
}

Après :

<?php
if (is_int($quantity) && is_float($price)) {
    $total = floatval($price) * $quantity;
}

Les alias ont la même sémantique. Ne supposez pas que is_float(40) soit vrai : un entier reste un entier. Ce comportement existait déjà avant la migration.

Pour un montant fourni sous forme de chaîne, floatval() est une conversion, et non une représentation décimale sûre pour les montants monétaires. Conservez la stratégie de gestion des montants déjà en place dans le projet plutôt que de la modifier à l'occasion d'une mise à niveau de PHP sans rapport avec ce point.

4. Migration des expressions régulières mbstring

La famille mb_ereg* est dépréciée parce que le moteur d'expressions régulières Oniguruma sur lequel elle repose n'est plus maintenu. PHP recommande PCRE pour de nombreux cas d'usage, mais les dialectes de motifs ne sont pas identiques.

Avant :

<?php
$isReference = mb_ereg('^[0-9]+$', $reference) !== false;

Après (chiffres ASCII uniquement) :

<?php
$isReference = preg_match('/^[0-9]+$/D', $reference) === 1;

Ici, le modificateur D fait en sorte que $ ne corresponde qu'à la fin de la chaîne. Pour du texte Unicode, utilisez un motif UTF-8 approprié et le modificateur u :

<?php
$isName = preg_match('/^\p{L}+(?:[ -]\p{L}+)*$/uD', $name) === 1;

Avant — remplacement :

<?php
$clean = mb_ereg_replace('[[:space:]]+', ' ', $text);
Illustration of the article's main concept

Après — remplacement :

<?php
$clean = preg_replace('/\s+/u', ' ', $text);
if ($clean === null) {
    throw new RuntimeException('Regular expression failed');
}

Les deux motifs peuvent se comporter différemment face à certains espaces Unicode. Pour une migration réelle, testez les caractères accentués, les retours à la ligne, le UTF-8 invalide, les groupes de capture et les références arrière sur les données réelles du projet. Ne remplacez pas en masse chaque appel à mb_ereg sans avoir examiné l'expression.

5. MySQLi : préparer une requête en une seule étape

Avant — déprécié :

<?php
$stmt = mysqli_stmt_init($mysqli);
mysqli_stmt_prepare($stmt, 'SELECT name FROM users WHERE id = ?');
mysqli_stmt_bind_param($stmt, 'i', $userId);
mysqli_stmt_execute($stmt);

Après :

<?php
$stmt = mysqli_prepare($mysqli, 'SELECT name FROM users WHERE id = ?');
mysqli_stmt_bind_param($stmt, 'i', $userId);
mysqli_stmt_execute($stmt);

Avec l'API orientée objet, utilisez $mysqli->prepare($sql) au lieu de $mysqli->stmt_init() suivi de prepare(). Conservez votre gestion des erreurs existante et fermez les requêtes correctement.

L'API distincte mysqli_get_charset() est également dépréciée. Si vous avez seulement besoin du nom du jeu de caractères actuel :

<?php
$charsetName = mysqli_character_set_name($mysqli);

Ce n'est pas un remplacement pour tous les champs de l'ancien objet d'informations sur le jeu de caractères. Si le code dépend des métadonnées de collation, examinez ce dont il a réellement besoin et interrogez le serveur en conséquence.

6. CSV : remplacer les méthodes CSV dépréciées de SplFileObject

Les méthodes spécifiques au CSV de SplFileObject sont dépréciées. Pour le code nouveau comme pour le code migré, utilisez les fonctions fgetcsv() et fputcsv(), qui reposent sur les flux.

Avant :

<?php
$file = new SplFileObject($path, 'r');
while (!$file->eof()) {
    $row = $file->fgetcsv();
    // Process row
}

Après :

<?php
$handle = fopen($path, 'rb');
if ($handle === false) {
    throw new RuntimeException('Cannot open CSV file');
}
try {
    while (($row = fgetcsv($handle, 0, ',', '"', '')) !== false) {
        // Process row
    }
} finally {
    fclose($handle);
}

L'argument escape vide désactive le mécanisme d'échappement propriétaire de PHP ; testez ce choix en fonction du format exporté par votre système source. Vérifiez les lignes vides, les en-têtes, les séparateurs, les retours à la ligne intégrés et l'encodage. Cet exemple illustre le changement d'API, et non un analyseur CSV universel.

Pour l'écriture, utilisez fputcsv($handle, $fields, ',', '"', ''). Conservez le dialecte attendu par le fichier d'origine.

7. Identité d'objet : spl_object_hash() n'est pas une empreinte de contenu

Avant :

<?php
$key = spl_object_hash($object);

Après :

<?php
$key = spl_object_id($object);

Le remplacement renvoie un entier, et non une chaîne. Si les clés sont sérialisées, stockées dans une base de données ou exposées via une API, examinez d'abord les consommateurs. Aucune des deux fonctions ne produit un identifiant persistant d'une requête à l'autre, et les identifiants peuvent être réutilisés après la destruction des objets. Pour une table de correspondance (map) indexée par l'identité d'objets vivants, envisagez SplObjectStorage ou WeakMap, selon les exigences de durée de vie.

8. Un return dans finally peut masquer des échecs

Avant — déprécié et trompeur :

<?php
function loadSettings(): array
{
    try {
        return readSettings();
    } finally {
        return []; // Overrides the result and hides exceptions
    }
}

Après — conserver le nettoyage sans écraser le résultat :

Technical workflow illustration
<?php
function loadSettings(): array
{
    try {
        return readSettings();
    } finally {
        releaseTemporaryResources();
    }
}

Si le code d'origine renvoyait volontairement une valeur de repli, déplacez cette décision dans un bloc catch avec une gestion explicite. Ne supprimez pas silencieusement une exception qui devrait parvenir à l'appelant.

9. Tri sensible à la locale et autres changements moins évidents

strcoll() et l'option de tri SORT_LOCALE_STRING sont dépréciés. L'alternative recommandée à intl est Collator :

<?php
$collator = new Collator('fr_FR');
$names = ['Émile', 'Alice', 'Zoé'];
$collator->sort($names);

Vérifiez que intl est installé. Le tri tenant compte de la locale est une règle métier : testez l'ordre attendu plutôt que de supposer qu'ICU et une locale globale au processus se comporteront toujours de manière identique.

D'autres éléments de migration méritent une attention explicite :

  • ArrayIterator : les méthodes de tri, les options (flags) et les méthodes de sérialisation telles que asort(), ksort(), setFlags() et serialize() sont dépréciées. Triez le tableau sous-jacent ou utilisez ArrayObject lorsque son API convient ; ne supposez pas qu'un itérateur et un conteneur soient interchangeables.
  • Gestionnaires de session personnalisés : implémentez à la fois create_sid() et validateId(), comme l'exigent les interfaces et le comportement mis à jour. PHP 8.6 active des valeurs par défaut plus strictes pour les sessions ; testez la connexion, la rotation des sessions et leur persistance.
  • __debugInfo() : utilisez un type de retour array non nullable ; le fait de renvoyer null était déjà déprécié.
  • define() : supprimez le troisième argument case_insensitive, même lorsqu'il vaut false.
  • http_build_query() et array_walk() : le fait de passer des objets là où des tableaux sont attendus est déprécié. Convertissez délibérément avec get_object_vars() ou construisez explicitement le tableau souhaité.
  • metaphone() : il n'existe aucun remplacement natif équivalent dans le cœur de PHP. Choisissez et testez un algorithme phonétique maintenu et adapté à la langue.
  • Identifiants réservés : des noms tels que let, is, readonly (fonction) et namespace (constante de classe) font l'objet de nouvelles restrictions de dépréciation. Renommez avec soin les déclarations concernées.
  • Reflection : examinez les objets invalides passés à ReflectionProperty::setValue() ainsi que les arguments de type objet fournis lors de l'appel de méthodes statiques.

Consultez le guide de migration complet pour les cas limites non couverts par cette sélection pratique.

10. Rechercher les appels dépréciés dans un projet existant

Commencez par un inventaire en lecture seule. Sous Linux ou macOS :

grep -RnE --include='*.php' \
  'is_integer\(|is_long\(|is_double\(|doubleval\(|spl_object_hash\(|mb_ereg\(|mb_ereg_replace\(|mysqli_stmt_init\(|mysqli_get_charset\(' \
  ./src

Remplacez ./src par le répertoire réel. Cette recherche textuelle peut correspondre à des commentaires ou des chaînes, et manquera les appels dynamiques, les alias avec espaces de noms et d'autres API dépréciées. C'est un point de départ, et non un analyseur statique complet.

Pour une solution multiplateforme, la fonction Rechercher dans les fichiers d'un éditeur peut rechercher les mêmes noms. Ne modifiez pas directement les fichiers du dossier vendor ou du cœur du CMS : mettez à jour le paquet en amont ou soumettez un correctif à son mainteneur.

Un processus de migration PHP 8.6 sûr, avec préproduction, examen des journaux et tests de non-régression

Une séquence de migration reproductible

  1. Notez la version actuelle de PHP et les extensions activées.
  2. Sauvegardez les fichiers et la base de données ; préparez une copie de préproduction.
  3. Exécutez le projet sous PHP 8.6 avec la journalisation des dépréciations activée.
  4. Inventoriez les avertissements par fichier et par ligne, puis regroupez-les par API.
  5. Corrigez votre propre code (first-party) par des modifications ciblées ; mettez à jour séparément les dépendances tierces.
  6. Relancez les tests unitaires et d'intégration ainsi que les parcours utilisateur importants.
  7. Vérifiez les formulaires, la connexion, les sessions, les e-mails, les paiements, les tâches planifiées, l'import/export CSV et l'accès à la base de données.
  8. Déployez avec un plan de retour arrière (rollback) ; surveillez les journaux d'erreurs après la mise en production.

Joomla et WordPress : le fait que PHP 8.6 soit sorti ne signifie pas que chaque version du CMS, chaque extension ou chaque plugin le prend en charge. Confirmez la compatibilité avec les versions exactes utilisées et testez d'abord un environnement de préproduction. Ne profitez pas de la mise à niveau pour corriger directement le code du cœur ou du dossier vendor.

11. Qu'y a-t-il réellement de nouveau dans PHP 8.6 ?

Au-delà des dépréciations, cette version ajoute plusieurs fonctionnalités de langage et de runtime :

Fonctionnalité Usage pratique
Application partielle de fonction Préremplir des arguments et obtenir un appelable pour les autres
clamp() Contraindre une valeur entre un minimum et un maximum
\Time\Duration Représenter un temps écoulé plutôt qu'une date calendaire
SortDirection Exprimer un sens croissant ou décroissant via une énumération (enum) standard
Io\Poll Prendre en charge l'interrogation de flux (stream polling) dans les bibliothèques de boucle d'événements et d'E/S
Valeurs par défaut pour les propriétés readonly Simplifier certaines déclarations de classes immuables

Un petit exemple immédiatement utile est clamp() :

<?php
// Before PHP 8.6
$percentage = min(100, max(0, $input));

// PHP 8.6
$percentage = clamp($input, 0, 100);

Le code est plus facile à lire, mais la priorité de la migration doit rester le test de compatibilité. Les autres fonctionnalités ne sont pas nécessaires pour simplement maintenir une application existante en état de marche. Voir l'annonce officielle de la version.

12. Avant de changer la version de PHP en production

Considérez PHP 8.6 comme une mise à niveau contrôlée, et non comme un bouton à cliquer sur un serveur de production en pleine activité. Une liste de contrôle raisonnable avant la mise en production est la suivante : CMS et dépendances pris en charge ; extensions disponibles ; pas d'afflux inattendu d'avis de dépréciation ; tests réussis ; comportement de la base de données et des sessions vérifié ; sauvegardes testées ; et procédure de retour arrière.

En résumé : PHP 8.6 apporte des fonctionnalités utiles, mais ce sont souvent ses dépréciations qui marquent le début du travail de maintenance. Corrigez d'abord les alias simples, puis testez les migrations de comportement — en particulier les expressions régulières, le CSV, les sessions et les opérations sensibles à la locale — sur des données réelles.

Sources officielles