array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'migration84.incompatible.php', 1 => 'Changements non rétrocompatibles', 2 => 'Changements non rétrocompatibles', ), 'up' => array ( 0 => 'migration84.php', 1 => 'Migration de PHP 8.3.x vers PHP 8.4.x', ), 'prev' => array ( 0 => 'migration84.constants.php', 1 => 'Nouvelles constantes globales', ), 'next' => array ( 0 => 'migration84.deprecated.php', 1 => 'Fonctionnalités dépréciées', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'appendices/migration84/incompatible.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Changements non rétrocompatibles

Sauf mention contraire dans cette section, chaque nouvelle fonction, classe, interface, énumération, ou constante peut entraîner le lancement d'une exception de redéclaration Error.

PHP Core

Changement du comportement de exit()

Les constructions de langage exit() (et die()) se comportent désormais davantage comme une fonction. Cela signifie qu'elles peuvent maintenant être passées comme des callables, sont affectées par l'instruction strict_types, et effectuent désormais les coercitions de type habituelles au lieu de caster toute valeur non entière en chaîne.

En conséquence, passer des types invalides à exit() et die() entraîne désormais systématiquement le lancement d'une exception TypeError.

Récursion lors de la comparaison

Rencontrer une récursion lors de la comparaison entraîne désormais une exception Error au lieu d'une erreur fatale E_ERROR.

Modification indirecte de propriétés en lecture seule

La modification indirecte de propriétés en lecture seule dans __clone() n'est plus autorisée, par exemple $ref = &$this->readonly. C'était déjà interdit pour l'initialisation en lecture seule, et c'était un oubli dans l'implémentation de la "réinitialisation en lecture seule lors du clonage".

Changement de type des constantes

Les constantes PHP_DEBUG et PHP_ZTS sont désormais de type bool. Auparavant, elles étaient de type int.

Longueur du nom de fichier temporaire

Le nom des fichiers téléversés et des fichiers créés par la fonction tempnam() est désormais plus long de 13 octets. La longueur totale dépend toujours de la plateforme.

Suppression du niveau d'erreur E_STRICT

Le niveau d'erreur E_STRICT a été supprimé, car il n'était plus utilisé dans le moteur PHP. La constante E_STRICT a également été dépréciée.

Constantes de classe d'extension désormais typées

Les constantes de classe suivantes déclarent désormais un type sur leurs constantes :

Migration des ressources vers des objets

Plusieurs resources ont été migrés vers des objets. La vérification de la valeur de retour à l'aide de is_resource() doit être remplacée par des vérifications de false, sauf indication contraire.

DBA

Les fonctions DBA acceptent et retournent désormais Dba\Connection à la place de resources dba_connection.

ODBC

Les fonctions ODBC acceptent et retournent désormais Odbc\Result à la place de resources odbc_result.

Les fonctions ODBC acceptent et retournent désormais Odbc\Connection à la place de resources odbc_connection.

SOAP

La propriété SoapClient::$httpurl est désormais un objet Soap\Url plutôt qu'une resource soap_url. Les vérifications à l'aide de is_resource() (par exemple is_resource($client->httpurl)) doivent être remplacées par des vérifications de null (par exemple $client->httpurl !== null).

La propriété SoapClient::$sdl est désormais un objet Soap\Sdl plutôt qu'une resource soap_sdl. Les vérifications à l'aide de is_resource() (par exemple is_resource($client->sdl)) doivent être remplacées par des vérifications de null (par exemple $client->sdl !== null).

Nouvelles alertes et exceptions

De nouvelles alertes et exceptions ont été ajoutées pour signaler des erreurs de programmation, c'est-à-dire des valeurs invalides fournies en argument.

Curl

curl_multi_select() lance désormais une ValueError si le paramètre timeout est inférieur à 0 ou supérieur à PHP_INT_MAX.

Gd

imagejpeg(), imagewebp(), imagepng(), imageavif() lancent désormais une ValueError si un quality invalide est passé.

imageavif() lance désormais une ValueError si un paramètre speed invalide est passé.

imagescale() lance désormais une ValueError si les paramètres width ou height sont en dehors des limites.

imagescale() lance désormais une ValueError si une valeur de mode invalide est passée.

imagefilter() lance désormais une ValueError avec le filtre IMG_FILTER_SCATTER si les paramètres sub ou plus sont en dehors des limites.

Gettext

bind_textdomain_codeset(), textdomain(), d*gettext lancent désormais une ValueError si le domain est la chaîne vide.

Intl

resourcebundle_get(), ResourceBundle::get(), et l'accès aux indices sur un ResourceBundle lancent désormais :

IntlDateFormatter::__construct() lance une ValueError si le locale est invalide.

NumberFormatter::__construct() lance une ValueError si le locale est invalide.

MBString

mb_encode_numericentity() et mb_decode_numericentity() vérifient désormais que map est uniquement composé de entiers, si ce n'est pas le cas, une ValueError est lancée.

mb_http_input() lance désormais une ValueError si le type est invalide.

mb_http_output() vérifie désormais que encoding ne contient pas de caractères nuls, si c'est le cas, une ValueError est lancée.

ODBC

odbc_fetch_row() retourne false lorsque row est inférieur ou égal à 0. Une alerte est désormais émise dans ce cas.

PCNTL

Les fonctions pcntl_sigprocmask(), pcntl_sigwaitinfo(), et pcntl_sigtimedwait() lancent désormais :

La fonction pcntl_sigprocmask() lance désormais une ValueError si le mode n'est pas l'une des SIG_BLOCK, SIG_UNBLOCK, ou SIG_SETMASK.

La fonction pcntl_sigtimedwait() lance désormais :

  • Une ValueError si seconds est inférieur à 0
  • Une ValueError si nanoseconds est inférieur à 0 ou supérieur à 1e9
  • Une ValueError si les deux seconds et nanoseconds sont 0

Session

Définir une valeur non positive pour session.gc_divisor ou une valeur négative pour session.gc_probability émet désormais une alerte.

SimpleXML

Appeler simplexml_import_dom() avec un objet non-XML lance désormais une TypeError au lieu d'une ValueError.

Standard

La fonction round() vérifie désormais la valeur du mode et lance une ValueError pour les modes invalides. Auparavant, les modes invalides auraient été interprétés comme PHP_ROUND_HALF_UP.

La fonction str_getcsv() lance désormais une ValueError si les arguments separator et enclosure ne font pas un octet de long, ou si l'argument escape n'est pas un octet de long ou une chaîne vide. Cela aligne le comportement pour être identique à celui de fputcsv() et fgetcsv().

La fonction php_uname() lance désormais une ValueError si le mode est invalide.

L'option "allowed_classes" pour unserialize() lance désormais une TypeError et une ValueError si ce n'est ni un array de noms de classe, ni un bool.

XMLReader

Passer un encodage de caractères invalide à XMLReader::open() ou XMLReader::XML() lance désormais une ValueError.

Passer une chaîne de caractères contenant des octets nuls émettait précédemment une alerte et lance désormais une ValueError.

XMLWriter

Passer une chaîne de caractères contenant des octets nuls émettait précédemment une alerte et lance désormais une ValueError.

XSL

XSLTProcessor::setParameter() lance désormais une ValueError lorsque ses arguments contiennent des octets nuls. Cela n'a jamais fonctionné correctement en premier lieu, c'est pourquoi une exception est maintenant lancée.

Appeler XSLTProcessor::importStyleSheet() avec un objet non-XML lance désormais une TypeError au lieu d'une ValueError.

L'échec d'appeler une fonction de rappel PHP pendant l'évaluation lance désormais une exception au lieu d'émettre une alerte.

Date

Le symbole number dans les formats relatifs accepte à nouveau plusieurs signes, par exemple +-2.

DOM

Quelques méthodes DOM retournaient précédemment false ou une DOMException DOM_PHP_ERR si un nouveau nœud ne pouvait pas être alloué. Elles lancent désormais systématiquement une DOMException DOM_INVALID_STATE_ERR. Cette situation est extrêmement improbable et la probabilité d'être affecté est faible. En conséquence, DOMImplementation::createDocument() a désormais un type de retour provisoire de DOMDocument à la place de DOMDocument|false.

Auparavant, les objets DOMXPath pouvaient être clonés, mais cela résultait en un objet inutilisable. Cela n'est plus possible, et cloner un objet DOMXPath lance désormais une Error.

La méthode DOMImplementation::getFeature() a été supprimée.

GMP

La classe GMP est désormais finale et ne peut plus être étendue.

MBString

À partir de PHP 8.3.2, en cas de chaînes invalides (celles avec des erreurs d'encodage), mb_substr() et mb_strstr() interprètent les indices de caractères de la même manière que la plupart des autres fonctions mbstring. Cela signifie que les indices de caractères retournés par mb_strpos() peuvent être passés à mb_substr().

Pour les chaînes SJIS-mac (MacJapanese), ces indices de caractères font référence aux indices des points de code Unicode qui sont produits lorsque la chaîne est convertie en Unicode, lesquels diffèrent des indices de caractères pour les caractères SJIS-mac qui se convertissent en une séquence de plusieurs points de code.

MySQLi

La constante non utilisée et non documentée MYSQLI_SET_CHARSET_DIR a été supprimée.

La constante MYSQLI_STMT_ATTR_PREFETCH_ROWS a été supprimée. Cette fonctionnalité n'est pas disponible avec mysqlnd.

Les constantes MYSQLI_CURSOR_TYPE_FOR_UPDATE et MYSQLI_CURSOR_TYPE_SCROLLABLE ont été supprimées. Ces fonctionnalités n'ont jamais été implémentées, ni avec mysqlnd ni avec libmysql.

La constante non utilisée MYSQLI_TYPE_INTERVAL, qui est actuellement un stub et un alias pour MYSQLI_TYPE_ENUM, a été supprimée.

MySQLnd

Le code d'erreur signalé pour les délais d'attente du serveur MySQL a été changé de 2006 à 4031 pour les versions du serveur Mysql 8.0.24 et supérieures.

Opcache

La valeur maximale de la configuration opcache.interned_strings_buffer sur les architectures 64 bits est désormais 32767. Auparavant, elle était de 4095.

JIT

La valeur par défaut de la configuration JIT a changé de opcache.jit=tracing et opcache.jit_buffer_size=0 pour opcache.jit=disable et opcache.jit_buffer_size=64M, respectivement.

Cela n'affecte pas le comportement observable par défaut, car le JIT est toujours désactivé par défaut. Cependant, il est désormais désactivé via la configuration opcache.jit, plutôt que opcache.jit_buffer_size. Cela peut affecter les utilisateurs qui ont précédemment activé le JIT via opcache.jit_buffer_size exclusivement, sans spécifier également un mode JIT en utilisant opcache.jit. Pour activer la compilation JIT, définissez la valeur de configuration opcache.jit en conséquence.

Si la compilation JIT est activée, PHP quittera désormais avec une erreur fatale au démarrage si l'initialisation du compilateur JIT a échoué pour une raison quelconque.

PCNTL

Les fonctions pcntl_sigprocmask(), pcntl_sigwaitinfo(), et pcntl_sigtimedwait() retournent désormais systématiquement false en cas d'échec. Dans certains cas précédemment, elles pouvaient retourner la valeur -1.

PCRE

La version de pcre2lib incluse a été mise à jour en version 10.44. Par conséquent, cela signifie que {,3} est désormais reconnu comme un quantificateur au lieu d'un texte. De plus, la signification de certaines classes de caractères en mode UCP a changé. Consulter le » Journal des modifications de PCRE2 pour un journal des modifications complet.

PDO_DBLIB

Les attributs Pdo\Dblib::ATTR_STRINGIFY_UNIQUEIDENTIFIER et Pdo\Dblib::ATTR_DATETIME_CONVERT agissent désormais comme des attributs booléens au lieu d'attributs entiers. Donc définir l'attribut via PDO::setAttribute() et le récupérer via PDO::getAttribute() attend et retourne un bool.

PDO_FIREBIRD

L'attribut PDO::ATTR_AUTOCOMMIT agit désormais comme un attribut booléen au lieu d'un attribut entier. Donc définir l'attribut via PDO::setAttribute() et le récupérer via PDO::getAttribute() attend et retourne un bool.

L'extension expose désormais certaines API C++ Firebird, donc la construction de cette extension nécessite désormais un compilateur C++. De plus, l'extension doit désormais être compilée contre fbclient 3.0 ou supérieur.

PDO_MYSQL

Les attributs PDO::ATTR_AUTOCOMMIT, PDO::ATTR_EMULATE_PREPARES, et PDO::MYSQL_ATTR_DIRECT_QUERY agissent désormais comme des attributs booléens au lieu d'attributs entiers. Donc définir l'attribut via PDO::setAttribute() et le récupérer via PDO::getAttribute() attend et retourne un bool.

PDO_PGSQL

Les informations de connexion DSN, lorsqu'elles sont définies, ont la priorité sur les arguments du constructeur PDO, étant plus proches de ce que la documentation indique.

SimpleXML

SimpleXMLElement n'est pas seulement une représentation d'un élément XML, mais c'est aussi un RecursiveIterator. Avant PHP 8.4.0, certaines de ses méthodes (par exemple SimpleXMLElement::asXML() ou SimpleXMLElement::getName()) et le casting de telles instances en chaîne de caractères réinitialisaient implicitement l'itérateur.

Cela pouvait entraîner des boucles infinies inattendues car l'itérateur était réinitialisé. Par exemple : 

<?php

$xmlString = "<root><a><b>1</b><b>2</b><b>3</b></a></root>";
$xml = simplexml_load_string($xmlString);

$nodes = $xml->a->b;
foreach ($nodes as $nodeData) {
    echo "nodeData: " . $nodeData . "\n";

    $xml = $nodes->asXml();
}

formait une boucle infinie. 

nodeData: 1
nodeData: 2
nodeData: 2
nodeData: 2
nodeData: 2
nodeData: 2
nodeData: 2
// ...

Cependant, ce comportement a été corrigé, et un SimpleXMLElement ne réinitialisera plus implicitement l'itérateur, sauf s'il est explicitement remis à zéro. Cela signifie que l'exemple précédent donnerait maintenant : 

nodeData: 1
nodeData: 2
nodeData: 3

SOAP

SoapClient::$typemap est désormais un array plutôt qu'une resource. Les vérifications à l'aide de is_resource() (c'est-à-dire is_resource($client->typemap)) doivent être remplacées par des vérifications de null (c'est-à-dire $client->typemap !== null).

L'extension SOAP a gagné une dépendance optionnelle sur l'extension session. Si PHP est compilé sans l'extension session et avec le drapeau de configuration --enable-rtld-now activé, des erreurs de démarrage se produiront désormais si l'extension SOAP est également utilisée. Pour résoudre ce problème, ne pas utiliser rtld-now ou charger l'extension session.

Standard

Lors de l'utilisation de strcspn() avec characters étant une chaîne vide, la longueur de la chaîne est désormais retournée au lieu de s'arrêter au premier octet nul.

http_build_query() gère désormais correctement les énumérations dotées d'une valeur.

stream_bucket_make_writeable() et stream_bucket_new() retournent désormais une instance de StreamBucket à la place d'une instance de stdClass.

Tidy

Les échecs dans le constructeur lancent désormais des exceptions plutôt que d'émettre des alertes et d'avoir un objet cassé.

XML

Les fonctions xml_set_*_handler déclarent désormais et vérifient une signature effective de callable|string|null pour les paramètres handler. De plus les valeurs de type string correspondant à des noms de méthode, d'objet défini avec xml_set_object() sont désormais vérifiées pour voir si la méthode existe sur la classe de l'objet précédemment passé. Cela signifie que xml_set_object() doit maintenant toujours être appelée avant de définir des noms de méthode en tant que callable. Passer une chaîne vide pour désactiver le gestionnaire est toujours autorisé, mais déprécié.

De plus, avec xml_set_object() et le passage de chaînes non-callable est déprécié. Il est recommandé de remplacer de telles instances par un callable se référant directement à la méthode.