set_error_handler

Description

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

set_error_handler() peut être utilisé pour définir votre propre manière de gérer les erreurs durant l'exécution, par exemple pour une application dans laquelle vous devez nettoyer les données/fichiers lorsqu'une erreur survient ou lorsque vous devez déclencher une erreur sous certaines conditions (en utilisant trigger_error()).

Il faut se rappeler que la fonction standard de traitement des erreurs de PHP est alors complètement ignorée. error_reporting() n'aura plus d'effet, et votre fonction de gestion des erreurs sera toujours appelée. Vous pourrez toujours lire la valeur de l'erreur courante de error_reporting et faire réagir la fonction de gestion des erreurs en fonction. Cette remarque est notamment valable si la commande a été préfixée par @.

Notez aussi qu'il est alors confié à cette fonction de terminer le script (die()) si nécessaire. Si la fonction de gestion des erreurs se termine normalement, l'exécution du script se poursuivra avec l'exécution de la prochaine commande.

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 ainsi que la plupart des E_STRICT d'un fichier lorsque 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

Valeurs de retour

Retourne une chaîne de caractères contenant le dernier gestionnaire d'erreurs (si il y en avait un) ou NULL en cas d'erreur. Si l'ancien gestionnaire d'erreurs était une méthode d'une classe, cette fonction retournera un tableau indexé avec les noms de la classe et de la méthode.

Historique

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 // Configure le niveau de rapport d'erreur pour ce script error_reporting(E_USER_ERROR | E_USER_WARNING | E_USER_NOTICE); // Gestionnaire d'erreurs function myErrorHandler($errno, $errstr, $errfile, $errline) {   switch ($errno) {   case E_USER_ERROR:     echo "<b>Mon ERREUR</b> [$errno] $errstr<br />\n";     echo "  Erreur fatale à la ligne $errline dans le fichier $errfile";     echo ", PHP " . PHP_VERSION . " (" . PHP_OS . ")<br />\n";     echo "Abandon...<br />\n";     exit(1);     break;   case E_USER_WARNING:     echo "<b>Mon ALERTE</b> [$errno] $errstr<br />\n";     break;   case E_USER_NOTICE:     echo "<b>Ma NOTICE</b> [$errno] $errstr<br />\n";     break;   default:     echo "Type d'erreur inconnu : [$errno] $errstr<br />\n";     break;   } } // Fonction pour tester la gestion d'erreur function scale_by_log($vect, $scale) {   if (!is_numeric($scale) || $scale <= 0) {     trigger_error("log(x) for x <= 0 est indéfini, vous utilisez : scale = $scale", E_USER_ERROR);   }   if (!is_array($vect)) {     trigger_error("Entrée incorrect, tableau de valeurs attendu", E_USER_WARNING);     return null;   }   for ($i=0; $i<count($vect); $i++) {     if (!is_numeric($vect[$i]))       trigger_error("La valeur à la position $i n'est pas un nombre, utilisation de 0 (zéro)", E_USER_NOTICE);       $temp[$i] = log($scale) * $vect[$i];     }     return $temp;   } // Configuration du gestionnaire d'erreurs $old_error_handler = set_error_handler("myErrorHandler"); // Génération de quelques erreurs. Commençons par créer un tableau echo "vector a\n"; $a = array(2,3, "foo", 5.5, 43.3, 21.11); print_r($a); // Générons maintenant un autre tableau, avec des alertes echo "----\nvector b - a warning (b = log(PI) * a)\n"; $b = scale_by_log($a, M_PI); print_r($b); // Ceci est un problème, nous avons utilisé une chaîne au lieu d'un tableau echo "----\nvector c - an error\n"; $c = scale_by_log("not array", 2.3); var_dump($c); // Ceci est une erreur critique : le logarithme de zéro ou d'un nombre négatif est indéfini echo "----\nvector d - fatal error\n"; $d = scale_by_log($a, -2.5); ?> L'exemple ci-dessus va afficher quelque chose de similaire à : vector a Array ( [0] => 2 [1] => 3 [2] => foo [3] => 5.5 [4] => 43.3 [5] => 21.11 ) ---- vector b - a warning (b = log(PI) * a) <b>Mon ALERTE</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 error <b>Mon ERREUR</b> [512] Entrée incorrect, tableau de valeurs attendu<br /> NULL ---- vector d - fatal error <b>Mon ERREUR FATALE</b> [256] log(x) for x <= 0 est indéfini, vous utilisez : scale = -2.5<br /> Erreur fatale à la ligne 36 dans le fichier trigger_error.php, PHP 4.0.2 (Linux)<br /> Abandon...<br />

Voir aussi