Changements incompatibles avec les versions précédentes
Même si la majorité du code PHP 5 devrait fonctionner sans modification, il est recommandé de surveiller les points suivants, qui introduisent des incompatibilités avec les versions précédentes.
-
La fonction getrusage() retourne
NULL
quand on lui passe des arguments incorrects depuis PHP 5.2.1. -
ZipArchive::setCommentName()
retourne
TRUE
en cas de succès depuis PHP 5.2.1. -
ZipArchive::setCommentIndex()
retourne
TRUE
en cas de succès depuis PHP 5.2.1. - SplFileObject::getFilename() retourne le nom du fichier, et non plus le chemin relatif jusqu'au fichier, depuis PHP 5.2.1.
- Changement de priorité de la constante d'environnement PHPRC sur Windows 32. La variable d'environnement PHPRC a la priorité sur la valeur enregistrée dans la base de registre Windows.
- CLI SAPI ne cherche plus dans cwd le fichier php.ini ni le fichier php-cli.ini En PHP 5.1.x, une fonctionnalité non-documentée a été ajoutée à la version CLI de PHP, pour rechercher dans le dossier courant un fichier de configuration PHP, menant à des comportements inattendus, si des fichiers inopinés étaient trouvés. Cette fonctionnalité a été supprimée en PHP 5.2.0, et PHP ne cherche plus dans le dossier de travail courant le fichier php.ini ni le fichier php-cli.ini. Voyez aussi la section sur la ligne de commande du manuel.
-
Ajout d'une alerte lors de calcul de modulo 0
Dans les versions précédentes de PHP, effectuer un calcul de modulo 0
ne donnait aucun message d'alerte, mais retournait la valeur inattendue
FALSE
. Depuis PHP 5.2.0, cette tentative conduit à l'émission d'une alerte de typeE_WARNING
, comme lorsque des divisions par zéro sont effectuées.<?php print 10 % 0; /* Warning: Division by zero in filename on line n */ ?>
-
Désormais, __toString() est appelé à chaque fois que c'est possible.
La méthode magique __toString() est maintenant appelée dans tout
contexte de chaîne, c'est à dire à chaque fois qu'un objet est utilisé comme chaîne
de caractères.
Le comportement par défaut qui retournait une chaîne représentant l'identifiant de
l'objet a été abandonné en PHP 5.2.0. Il était devenu problématique, car un identifiant
d'objet ne peut pas être considéré comme unique. Ce changement implique que votre
application est erronée si elle utilise les identifiants d'objets comme valeur de
retour. Une tentative d'utilisation de cette valeur comme chaîne de caractères
produit maintenant une erreur fatale.
<?php class foo {} $foo = new foo; print $foo; /* Catchable fatal error: Object of class foo could not be converted to string in filename on line n */ ?>
<?php class foo { public function __toString() { throw new Exception; } } try { print new foo; /* Fatal error: Method foo::__toString() must not throw an exception in filename on line n */ } catch(Exception $e) {} ?>
-
Abandon des fonctions de classes statiques et abstraites.
A cause d'une inattention, PHP 5.0.x et 5.1.x permettaient les méthodes statiques
abstraites dans les classes. Depuis PHP 5.2.x, seules les interfaces peuvent en avoir.
<?php abstract class foo { abstract static function bar(); /* Strict Standards: Static function foo::bar() should not be abstract in filename on line n */ } ?>
- L'extension Oracle nécessite au moins la version 10 d'Oracle, sous Windows.
-
Ajout du support de la RFC2397 (flux data:).
L'introduction du flux de type 'data' peut conduire à un changement de comportement
sous Windows. Si vous travaillez avec un système de fichiers NTFS,
que vous utilisez vos propres meta-flux dans vos applications, et que vous
avez déjà baptisé l'un des fichiers du nom de 'data:', accessible sans aucune
information de chemin, sachez qu'il ne fonctionnera plus. Le correctif est d'utiliser
le protocole 'file:' pour y accéder.
Voyez aussi la » RFC 2397
<?php /* lorsque allow_url_include vaut OFF (valeur par défaut) */ include "data:;base64,PD9waHAgcGhwaW5mbygpOz8+"; /* Warning: include(): URL file-access is disabled in the server configuration in filename on line n */ ?>
-
Régression dans le masque glob()
Dans la version 5.2.4, une mise à jour de sécurité a provoqué une régression
des masques de la forme "/foo/*/bar/*". Depuis la version 5.2.5, au lieu d'émettre
une alerte, la fonction glob() retourne
FALSE
lorsque les restrictions openbase_dir sont violées.