set_exception_handler

(PHP 5, PHP 7, PHP 8)

set_exception_handler — Définit une fonction utilisateur de gestion d'exceptions

Description

set_exception_handler(?callable $callback): ?callable

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 callback.

Liste de paramètres

callback

La fonction à appeler quand une exception non attrapée se produit. Cette fonction de gestion doit accepter un paramètre, qui sera l'objet Throwable qui a été lancé. Les classes Error et Exception implémentent l'interface Throwable. Ceci est la signature du gestionnaire :

handler(Throwable $ex): void

null peut être passé à la place, pour ré-initialiser ce gestionnaire en son statut initial.

Valeurs de retour

Retourne le 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é.

Exemples

Exemple #1 Exemple avec set_exception_handler()

<?php
function exception_handler(Throwable $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