Fonction set_exception_handler() de PHP
Exemple
Définir la fonction de gestion des exceptions personnalisée :
<?php // Fonction de gestion des exceptions personnalisée function myException($exception) { echo "<b>Exception:</b> ", $exception->getMessage(); } // Définir le gestionnaire d'exception personnalisé set_exception_handler("myException"); // Lancer l'exception throw new Exception("Exception non capturée survenue !"); ?>
La sortie du code ci-dessus est similaire à ce qui suit :
Exception : Exception non capturée survenue !
Définition et utilisation
La fonction set_exception_handler() définit le gestionnaire d'exception personnalisé.
Le script s'arrête après que le gestionnaire d'exception a été appelé.
Syntaxe
set_exception_handler(exceptionhandler);
Paramètres | Description |
---|---|
exceptionhandler |
Obligatoire. Définit le nom de la fonction appelée lorsque se produit une exception non capturée. Remarque :Vous pouvez également transmettre une valeur NULL pour réinitialiser la fonction de gestion des exceptions à la valeur par défaut. |
Détails techniques
Valeur de retour : |
Retourne une chaîne contenant le nom du gestionnaire d'exception précédemment défini, ou NULL en cas d'erreur. NULL est également retourné si un gestionnaire d'erreurs n'a pas été défini précédemment. Si NULL est utilisé pour le paramètre, le gestionnaire est réinitialisé à l'état par défaut et TRUE est retourné. |
---|---|
Version PHP : | 5.0+ |
Journal des mises à jour PHP : |
PHP 7.0.0 : transmis à exception_handler Le type de paramètre est modifié de Exception à Throwable. Avant PHP 5.5, si NULL est transmis, la fonction retourne TRUE. Depuis PHP 5.5, elle retourne le gestionnaire précédent. |