PHP 8.6 : Nouvelles fonctionnalités, fonctions dépréciées et un guide de migration pratique
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.
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);

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 :

<?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 queasort(),ksort(),setFlags()etserialize()sont dépréciées. Triez le tableau sous-jacent ou utilisezArrayObjectlorsque 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()etvalidateId(), 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 retourarraynon nullable ; le fait de renvoyernullétait déjà déprécié.define(): supprimez le troisième argumentcase_insensitive, même lorsqu'il vautfalse.http_build_query()etarray_walk(): le fait de passer des objets là où des tableaux sont attendus est déprécié. Convertissez délibérément avecget_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) etnamespace(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.
Une séquence de migration reproductible
- Notez la version actuelle de PHP et les extensions activées.
- Sauvegardez les fichiers et la base de données ; préparez une copie de préproduction.
- Exécutez le projet sous PHP 8.6 avec la journalisation des dépréciations activée.
- Inventoriez les avertissements par fichier et par ligne, puis regroupez-les par API.
- Corrigez votre propre code (first-party) par des modifications ciblées ; mettez à jour séparément les dépendances tierces.
- Relancez les tests unitaires et d'intégration ainsi que les parcours utilisateur importants.
- 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.
- 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.