set_error_handler

    (PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)

    set_error_handler — Spécifie une fonction utilisateur comme gestionnaire d'erreurs

    Description

    set_error_handler(?callable$callback, int$error_levels = E_ALL): ?callable

    set_error_handler() choisit la fonction utilisateur callback pour gérer les erreurs dans un script.

    Cette fonction peut être utilisée pour définir des gestionnaires d'erreurs personnalisés pendant l'exécution, par exemple dans des applications qui ont besoin de nettoyer des fichiers/données lorsqu'une erreur critique se produit ou lorsqu'une erreur est déclenchée en réponse à certaines conditions (à l'aide de la fonction trigger_error()).

    Il faut se rappeler que la fonction standard de traitement des erreurs de PHP est alors complètement ignorée pour les erreurs de types spécifiés par error_levels à moins que la fonction de rappel retourne false. Les paramètres de la fonction error_reporting() n'auront aucun effet et le gestionnaire d'erreurs sera appelé quoi qu'il arrive. Cependant, il est toujours possible de lire la valeur actuelle de la configuration de. error_reporting et faire réagir la fonction de gestion des erreurs en fonction.

    Notez aussi que c'est la responsabilité du gestionnaire d'erreurs d'arrêter l'exécution du script si nécessaire en appelant la fonction exit(). Si la fonction du gestionnaire d'erreurs retourne, l'exécution du script se poursuivra avec l'instruction suivante après celle qui a causé l'erreur.

    Les types d'erreur suivants ne peuvent pas être gérés avec cette fonction : E_ERROR, E_PARSE, E_CORE_ERROR, E_CORE_WARNING, E_COMPILE_ERROR, E_COMPILE_WARNING indépendamment d'où elles sont levées, ainsi que la plupart des E_STRICT du fichier dans lequel set_error_handler() est appelé.

    Si une erreur survient avant que le script ne soit exécuté (par exemple un téléchargement de fichier), le gestionnaire d'erreurs personnalisé ne pourra pas être appelé, car il n'est pas encore enregistré.

    Liste de paramètres

    callback

    Si null est fournie le gestionnaire est réinitialisé à son statut par défaut. Sinon, le gestionnaire est une fonction de rappel avec la signature suivante :

    handler(
        int$errno,
        string$errstr,
        string$errfile = ?,
        int$errline = ?,
        array$errcontext = ?
    ): bool
    errno
    Le premier paramètre errno, sera passé le niveau d'erreur, sous la forme d'un entier.
    errstr
    Le second paramètre errstr, sera passé le message d'erreur, sous forme de chaîne.
    errfile
    Si la fermeture accepte un troisième paramètre, errfile, il sera passé le nom du fichier dans lequel l'erreur a été identifiée, sous forme de chaîne.
    errline
    Si la fermeture accepte un quatrième paramètre, errline, il sera passé le numéro de ligne à laquelle l'erreur a été identifiée, sous la forme d'un entier.
    errcontext
    Si la fermeture accepte un cinquième paramètre, errcontext, il sera passé comme un tableau qui pointe sur la table des symboles actifs à l'instant où l'erreur est survenue. En d'autres termes, errcontext contient un tableau avec toutes les variables qui existaient lorsque l'erreur a été déclenchée. Les gestionnaires d'erreurs utilisateur ne doit pas modifier le contexte d'erreur.
    Avertissement

    Ce paramètre est OBSOLÈTE à partir de PHP 7.2.0, et SUPPRIMÉ à partir de PHP 8.0.0. Si la fonction définie ce paramètre sans valeur par défaut, une erreur de "too few arguments" sera levée lors de son appel.

    Si la fonction retourne false, alors le gestionnaire d'erreurs normal continue.

    error_levels

    Sert de masque pour appeler la fonction callback de la même façon que l'option de configuration error_reporting contrôle les erreurs qui sont affichées. Sans le masque, callback sera appelé pour toutes les erreurs, quelle que soit la valeur de error_reporting.

    Valeurs de retour

    Retourne le dernier gestionnaire d'erreurs (s'il existe). Si le gestionnaire d'erreurs natif est utilisé, null est retourné. Si le gestionnaire d'erreurs précédent est une méthode d'une classe, cette fonction retournera un tableau indexé de la classe et du nom de la méthode.

    Historique

    VersionDescription
    8.0.0errcontext a été supprimé, et ne sera plus passé aux fermetures utilisateur.
    7.2.0errcontext est devenu obsolète. L'usage de ce paramètre émet une notice E_DEPRECATED.

    Exemples

    Exemple #1 Gestionnaire d'erreurs avec set_error_handler() et trigger_error()

    L'exemple ci-dessous illustre l'interception d'erreurs internes avec génération d'erreur et son exploitation dans une fonction utilisateur :

    <?php
    // Gestionnaire d'erreurs
    function myErrorHandler($errno, $errstr, $errfile, $errline)
    {
    if (!(    error_reporting() & $errno)) {
    // Ce code d'erreur n'est pas inclus dans error_reporting(), donc il continue

    Résultat de l'exemple ci-dessus est similaire à :

    vector a Array ( [0] => 2 [1] => 3 [2] => foo [3] => 5.5 [4] => 43.3 [5] => 21.11 ) ---- vector b - a notice (b = log(PI) * a) <b>Mon AVERTISSEMENT</b> [1024] La valeur à la position 2 n'est pas un nombre, utilisation de 0 (zéro)<br /> Array ( [0] => 2.2894597716988 [1] => 3.4341896575482 [2] => 0 [3] => 6.2960143721717 [4] => 49.566804057279 [5] => 24.165247890281 ) ---- vector c - an warning <b>Mon ALERTE</b> [512] Entrée incorrect, tableau de valeurs attendu<br /> NULL ---- vector d - fatal error <b>Mon ERREUR</b> [256] log(x) for x <= 0 est indéfini, vous utilisez : scale = -2.5<br /> Erreur fatale sur la ligne 36 dans le fichier trigger_error.php, PHP 4.0.2 (Linux)<br /> Abandon...<br />

    Voir aussi

    To Top