Documentation PHP en français

  • Français

set_exception_handler

(PHP 5)

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

Description

callable set_exception_handler ( callable $exception_handler )

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.

Note:

NULL peut aussi être passé, pour réinitialiser ce gestionnaire en son statut par défaut.

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é. Si NULL est passé, le gestionnaire sera réinitialisé dans son état par défaut, et TRUE sera retourné.

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