Utilisation de "namespace" comme nom de constante de classe

Déclarer une constante de classe nommée namespace est désormais déprécié. namespace est un mot-clé semi-réservé, et ce nom est réservé pour une éventuelle syntaxe future, telle qu'une pseudo-constante ::namespace analogue à ::class. Les méthodes et les propriétés statiques nommées namespace ne sont pas concernées. Renommer la constante, par exemple en NAMESPACE_NAME.

Retourner depuis un bloc finally

Utiliser l'instruction return dans un bloc finally est désormais déprécié, et émet un avertissement de dépréciation à la compilation. Un tel return écarte silencieusement une exception lancée par le bloc try ou catch associé, ou écrase la valeur qu'il retourne, si bien que les échecs disparaissent sans laisser de trace. Il faut déplacer le return hors du bloc finally ; le même résultat peut toujours s'exprimer sans lui.

<?php
function getConfig(): array
{
    try {
        return loadConfig(); // lance une exception si le fichier est absent
    } finally {
        return []; // Déprécié : l'exception disparaît, l'appelant obtient simplement []
    }
}

Type de retour nullable pour __debugInfo()

Déclarer un type de retour ?array pour __debugInfo() est désormais déprécié. Retourner null depuis cette méthode était déjà déprécié en PHP 8.5, le type de retour nullable ne décrit donc plus un comportement valide. Il faut déclarer array à la place.

Retourner des valeurs depuis __construct() et __destruct()

Retourner une valeur depuis __construct() ou __destruct() est désormais déprécié, et émet un avertissement de dépréciation à la compilation. Ces méthodes ne peuvent pas déclarer de type de retour, et leur valeur de retour ne peut jamais être observée en usage normal, ce qui rendait le fait de retourner une valeur au mieux déroutant. Utiliser return; sans valeur pour ignorer le reste de la logique reste autorisé, de même que l'appel manuel de ces méthodes.

Pour la même raison, utiliser yield pour faire de __construct() ou __destruct() un générateur est désormais déprécié.

Nommer une fonction readonly

Déclarer une fonction nommée readonly est désormais déprécié. readonly est un mot-clé réservé ; une exception a été ajoutée à l'analyseur lexical en PHP 8.1 uniquement pour maintenir en état de fonctionnement une fonction WordPress existante portant ce nom, et aucun autre mot-clé de PHP ne bénéficie d'un traitement spécial de ce genre. Il faut renommer la fonction.

Utilisation de let, is ou _ comme identifiant

Utiliser let ou is comme nom de classe, d'interface, de trait, d'énumération, de fonction ou de constante (y compris via define()) est désormais déprécié, de même que leur utilisation comme alias dans un appel à class_alias() ou dans une déclaration use, use function ou use const. Ces noms sont réservés comme mots-clés pour d'éventuelles fonctionnalités futures : let pour la portée de bloc et is pour le filtrage par motifs. Il faut renommer les symboles concernés.

La dépréciation de _ comme nom de classe en PHP 8.4 est étendue aux constantes : déclarer une constante nommée _ avec const ou define(), et utiliser _ comme alias d'une classe ou d'une constante dans une déclaration use, sont désormais dépréciés. Les fonctions nommées _, y compris l'alias _() de gettext(), ne sont pas concernées.

Troisième argument de define()

Passer l'argument case_insensitive à define() est désormais déprécié. Les constantes insensibles à la casse ont été supprimées en PHP 8.0, et depuis lors cet argument est ignoré. Passer explicitement false émet désormais un avertissement de dépréciation. Passer true continue d'émettre un avertissement, dont le message précise désormais que cela deviendra une erreur en PHP 9.0. Il faut omettre l'argument.

is_a() et is_subclass_of() avec une chaîne lorsque allow_string vaut false

Appeler is_a() ou is_subclass_of() avec une chaîne comme premier argument alors que allow_string vaut false est désormais déprécié. Dans ce cas, les fonctions retournent toujours false, même lorsque la classe est déjà chargée, un tel appel révèle donc un bogue. Pour éviter de déclencher le chargement automatique, il faut d'abord vérifier avec class_exists() en désactivant le chargement automatique, puis appeler la fonction avec allow_string défini à true.

metaphone()

La fonction metaphone() est désormais dépréciée. Elle implémente l'algorithme Metaphone original de 1990, qui est limité aux règles de prononciation de l'anglais et a depuis longtemps été supplanté par Double Metaphone et Metaphone 3. Les algorithmes phonétiques sont spécifiques à une langue et fréquemment mis à jour ; ils sont donc mieux servis par une bibliothèque en espace utilisateur, qu'il faut utiliser à la place.

Plus de 16 filtres dans une URL php://filter

Utiliser plus de 16 filtres dans une URL php://filter sans configurer l'option de contexte de flux filter.max_filter_count émet désormais un avertissement de dépréciation. Les longues chaînes de filtres n'ont aucun usage légitime connu, mais sont à la base d'une classe d'attaques qui transforment une inclusion de fichier local ou une lecture arbitraire de fichier en exécution de code à distance. Lorsque filter.max_filter_count est défini explicitement, le dépasser est déjà une erreur : l'ouverture du flux échoue avec un avertissement.

Le code qui a besoin de davantage de filtres devrait soit les ajouter avec stream_filter_append() ou stream_filter_prepend(), qui ne sont pas limitées, soit relever la limite via l'option de contexte, par exemple globalement avec stream_context_set_default().

Passer des objets à array_walk(), array_walk_recursive() et http_build_query()

Passer un objet comme argument array à array_walk() ou array_walk_recursive() est désormais déprécié. Un petit nombre de fonctions interprètent silencieusement un objet comme le tableau de ses propriétés visibles. Modifier ces propriétés via une fonction de rappel par référence viole la sémantique de readonly et peut corrompre les cas d'énumération, et array_walk_recursive() ne descend de toute façon pas dans les objets imbriqués. Il faut d'abord appeler get_object_vars() sur l'objet et passer le tableau obtenu.

Passer un objet comme argument data à http_build_query() est désormais déprécié. Les objets rencontrés comme valeurs dans data émettent désormais aussi un avertissement de dépréciation lorsqu'ils sont interprétés comme des tableaux. Traiter les objets comme des tableaux a été une source récurrente de confusion, en particulier pour les objets Stringable, dont les utilisateurs attendent qu'ils soient plutôt convertis en chaîne. Il faut convertir les objets en tableaux avec get_object_vars(), récursivement si nécessaire, avant d'appeler la fonction.

is_double(), is_long(), is_integer() et doubleval()

Suite à la dépréciation des noms de cast non canoniques en PHP 8.5, les alias de fonctions qui portent ces mêmes noms de types obsolètes sont désormais dépréciés. Ils se comportent de manière identique à leurs équivalents canoniques, qui doivent être utilisés à la place :

• is_double() => is_float()
• is_long() => is_int()
• is_integer() => is_int()
• doubleval() => floatval()

strcoll() et SORT_LOCALE_STRING

La fonction strcoll() est désormais dépréciée. Elle compare des chaînes selon le paramètre LC_COLLATE de la locale courante, qui est un état global du processus défini via setlocale() et que n'importe quelle bibliothèque peut modifier ; elle n'est pas compatible avec les données binaires, contrairement à toutes les autres fonctions de comparaison de chaînes, et certaines locales n'implémentent pas des règles de collation correctes. Il faut utiliser à la place Collator::compare() de l'extension intl, qui est précise et dispose de règles de collation à jour.

Le drapeau SORT_LOCALE_STRING des fonctions de tri est désormais déprécié pour les mêmes raisons, puisqu'il trie en utilisant strcoll(). Il faut utiliser à la place l'une des méthodes suivantes de la classe Collator :

• Collator::sort()
• Collator::asort()
• Collator::sortWithSortKeys()