# 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

- get_exception_handler() - Renvoie la fonction de gestion d'exception définie par l'utilisateur
- 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
- Les exceptions