set_exception_handler
(PHP 5)
set_exception_handler — Définit une fonction utilisateur de gestion d'exceptions
Description
set_exception_handler() définit le gestionnaire d'exceptions
par défaut si une exception n'est pas attrapée avec un bloc
d'essai/d'attrape. L'exécution sera stoppée après l'appel à la
fonction exception_handler.
Liste de paramètres
-
exception_handler -
Nom de la fonction à appeler lorsqu'une exception qui n'a pu être attrapée survient. Cette fonction doit être définie avant l'appel de la fonction set_exception_handler(). Ce gestionnaire doit accepter un paramètre qui sera l'objet représentant l'exception qui vient d'être lancée. C'est le gestionnaire de signature :
NULLpeut être passé à la place, pour ré-initialiser ce gestionnaire en son statut initial.
Valeurs de retour
Retourne le nom du gestionnaire précédemment défini ou NULL en cas d'erreur.
Si aucun gestionnaire n'a été précédemment défini, NULL est également
retourné.
Historique
| Version | Description |
|---|---|
| 5.5.0 |
Précédemment, si NULL était passé, alors la fonction retournait
TRUE. Désormais, elle retourne le gestionnaire précédant, et ce,
depuis PHP 5.5.0.
|
Exemples
Exemple #1 Exemple avec set_exception_handler()
<?php
function exception_handler($exception) {
echo "Exception non attrapée : " , $exception->getMessage(), "\n";
}
set_exception_handler('exception_handler');
throw new Exception('Uncaught Exception');
echo "Non exécuté\n";
?>Voir aussi
- restore_exception_handler() - Réactive l'ancienne fonction de gestion d'exceptions
- restore_error_handler() - Réactive l'ancienne fonction de gestion des erreurs
- error_reporting() - Fixe le niveau de rapport d'erreurs PHP
- Informations sur le type callback
- Les exceptions en PHP 5
