PHP set_error_handler()Fonctions


PHP Error 参考手册Manuel de référence complet des erreurs PHP

Définition et utilisation

La fonction set_error_handler() définit une fonction de gestion des erreurs définie par l'utilisateur.

Cette fonction est utilisée pour créer la méthode de gestion des erreurs propre à l'utilisateur pendant l'exécution.

Cette fonction retourne l'ancien gestionnaire d'erreurs, ou NULL en cas d'échec.

Syntaxe

set_error_handler(error_function,error_types)

Parameters Description
error_function Obligatoire. Spécifie la fonction à exécuter lorsqu'une erreur se produit.
error_types Facultatif. Spécifie le niveau de rapport d'erreurs qui affichera les erreurs définies par l'utilisateur. La valeur par défaut est "E_ALL". Voir le tableau ci-dessous pour les niveaux de rapport d'erreurs possibles.

error_function

Syntaxe

error_function(error_level,error_message,
error_file,error_line,error_context)

Parameters Description
error_level Obligatoire. Spécifie le niveau de rapport d'erreurs pour les erreurs définies par l'utilisateur. Doit être une valeur numérique. Voir le tableau ci-dessous pour les niveaux de rapport d'erreurs possibles.
error_message Requis. Spécifie le message d'erreur pour l'erreur définie par l'utilisateur.
error_file Optionnel. Spécifie le nom du fichier dans lequel l'erreur s'est produite.
error_line Optionnel. Spécifie le numéro de ligne dans laquelle l'erreur s'est produite.
error_context Optionnel. Spécifie un tableau pointant vers la table des symboles active où l'erreur s'est produite. En d'autres termes, error_context contiendra un tableau expliquant la portée dans laquelle existe chaque variable ayant causé l'erreur.

Niveaux de rapport d'erreurs

Valeur Constante Description
2 E_WARNING Erreurs non fatales à l'exécution. L'exécution du script n'est pas arrêtée.
8 E_NOTICE Notices d'exécution. Le script découvre quelque chose qui pourrait être une erreur, mais cela peut également survenir pendant l'exécution normale du script.
256 E_USER_ERROR Erreur fatale générée par l'utilisateur. C'est comme une E_ERROR générée par le programmeur à l'aide de la fonction PHP trigger_error().
512 E_USER_WARNING Erreur non fatale générée par l'utilisateur. C'est comme une E_WARNING générée par le programmeur à l'aide de la fonction PHP trigger_error().
1024 E_USER_NOTICE Notice générée par l'utilisateur. C'est comme un E_NOTICE généré par le programmeur à l'aide de la fonction PHP trigger_error().
4096 E_RECOVERABLE_ERROR Erreur fatale capturable. C'est comme un E_ERROR qui peut être capturé par un gestionnaire défini par l'utilisateur (voir set_error_handler()).
8191 E_ALL Tous les niveaux d'erreur et d'avertissement, sauf E_STRICT (depuis PHP 6.0, E_STRICT fera partie de E_ALL).


Conseils et notes

Astuce :Si cette fonction est utilisée, la fonction standard de gestion des erreurs de PHP est complètement contournée. Si nécessaire, le gestionnaire d'erreurs défini par l'utilisateur doit terminer le script (die()).

Remarque :Si une erreur se produit avant l'exécution du script, le gestionnaire d'erreurs personnalisé ne sera pas utilisé car le gestionnaire personnalisé n'a pas encore été enregistré à ce moment-là.


Exemples

<?php
//fonction de gestion des erreurs
function customError($errno, $errstr, $errfile, $errline)
{
echo "<b>Erreur personnalisée :</b> [$errno] $errstr<br />";
echo " Erreur à la ligne $errline dans $errfile<br />";
echo "Ending Script";
die();
}

//définir le gestionnaire d'erreurs
set_error_handler("customError");

$test=2;

//déclencher une erreur
if ($test>1)
{
trigger_error("A custom error has been triggered");
}
?>

La sortie du code ci-dessus est affichée ci-dessous :

Erreur personnalisée : [1024] Une erreur personnalisée a été déclenchée
Erreur à la ligne 19 dans C:webfoldertest.php
Fin du script


PHP Error 参考手册Manuel de référence complet des erreurs PHP Autres extensions