set_error_handler Spécifie une fonction utilisateur comme gestionnaire d'erreurs &reftitle.description; mixedset_error_handler callableerror_handler interror_typesE_ALL | E_STRICT 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 pour les erreurs de types spécifiés par error_types à moins que la fonction de rappel retourne &false;. 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. Antérieur à PHP 8.0.0, la valeur de errno était toujours 0 si l'expression qui a causé le diagnostic a été préfixé de l' opérateur de contrôle d'erreur @. 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 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é. &reftitle.parameters; error_handler Une fonction de rappel avec la signature suivante. &null; peut être passé à la place, pour ré-initialiser ce gestionnaire en son statut par défaut. Au lieu d'un nom de fonction, un tableau contenant une référence d'objet et un nom de méthode peut également être fourni. boolhandler interrno stringerrstr stringerrfile interrline arrayerrcontext 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. Ce paramètre est OBSOLÈTE à partir de PHP 7.2.0, et SUPPRIMÉ à partir de PHP 8.0.0. Si votre 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_types Sert de masque pour appeler la fonction error_handler de la même façon que l'option de configuration error_reporting contrôle les erreurs qui sont affichées. Sans le masque, error_handler sera appelé pour toutes les erreurs, quelle que soit la valeur de error_reporting. &reftitle.returnvalues; Retourne une chaîne contenant le dernier gestionnaire d'erreurs (s'il existe). Si le gestionnaire d'erreurs natif est utilisé, &null; est retourné. &null; est également retourné dans le cas d'une erreur, comme une fonction de rappel incorrecte. 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. &reftitle.changelog; &Version; &Description; 8.0.0 errno ne vaut désormais plus 0 quand l'expression a été ignoré par l' opérateur de contrôle d'erreur @. 8.0.0 errcontext a été supprimé, et ne sera plus passé aux fermetures utilisateur. 7.2.0 errcontext est devenu obsolète. L'usage de ce paramètre émet une notice E_DEPRECATED. &reftitle.examples; L'exemple ci-dessous illustre l'interception d'erreurs internes avec génération d'erreur et son exploitation dans une fonction utilisateur : Mon ERREUR [$errno] $errstr
\n"; echo " Erreur fatale sur la ligne $errline dans le fichier $errfile"; echo ", PHP " . PHP_VERSION . " (" . PHP_OS . ")
\n"; echo "Arrêt...
\n"; exit(1); case E_USER_WARNING: echo "Mon ALERTE [$errno] $errstr
\n"; break; case E_USER_NOTICE: echo "Mon AVERTISSEMENT [$errno] $errstr
\n"; break; default: echo "Type d'erreur inconnu : [$errno] $errstr
\n"; break; } /* Ne pas exécuter le gestionnaire interne de PHP */ return true; } // 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 is undefined, you used: scale = $scale", E_USER_ERROR); } if (!is_array($vect)) { trigger_error("Type d'entrée incorrect, tableau de valeurs attendu", E_USER_WARNING); return null; } $temp = array(); foreach($vect as $pos => $value) { if (!is_numeric($value)) { trigger_error("La valeur à la position $pos n'est pas un nombre, utilisation 0 (zéro)", E_USER_NOTICE); $value = 0; } $temp[$pos] = log($scale) * $value; } 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 second tableau echo "----\nvector b - a notice (b = log(PI) * a)\n"; /* Valeur à la position $pos n'est pas un nombre, utilisation de 0 (zéro) */ $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 - a warning\n"; /* Type d'entrée incorrect, tableau de valeurs attendu */ $c = scale_by_log("non un tablau", 2.3); var_dump($c); // NULL // 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"; /* log(x) pour x <= 0 est indéfini, vous utilisez : scale = $scale" */ $d = scale_by_log($a, -2.5); var_dump($d); // Jamais atteint ?> ]]> &example.outputs.similar; 2 [1] => 3 [2] => foo [3] => 5.5 [4] => 43.3 [5] => 21.11 ) ---- vector b - a notice (b = log(PI) * a) Mon AVERTISSEMENT [1024] La valeur à la position 2 n'est pas un nombre, utilisation de 0 (zéro)
Array ( [0] => 2.2894597716988 [1] => 3.4341896575482 [2] => 0 [3] => 6.2960143721717 [4] => 49.566804057279 [5] => 24.165247890281 ) ---- vector c - an warning Mon ALERTE [512] Entrée incorrect, tableau de valeurs attendu
NULL ---- vector d - fatal error Mon ERREUR [256] log(x) for x <= 0 est indéfini, vous utilisez : scale = -2.5
Erreur fatale sur la ligne 36 dans le fichier trigger_error.php, PHP 4.0.2 (Linux)
Abandon...
]]> &reftitle.seealso; ErrorException error_reporting restore_error_handler trigger_error Constantes de niveau d'erreur