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 type E_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 */
    ?>
    Même avec __toString(), les objets ne peuvent pas être utilisés comme des index ou des clés de tableaux. Nous envisageons d'ajouter un support natif de hachage ultérieurement, mais pour les versions 5.2.x, vous devrez fournir votre propre système, ou bien utiliser la nouvelle fonction SPL spl_object_hash(). __toString() ne peut pas émettre d'exception.
    <?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.