PHP set_error_handler()Fonctions
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
| 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_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
//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 à la ligne 19 dans C:webfoldertest.php
Fin du script
Manuel de référence complet des erreurs PHP Autres extensions