set_exception_handler

(PHP 5, PHP 7)

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. 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 avant PHP 7 :

void handler ( Exception $ex )

Depuis PHP 7, la plupart des erreurs sont rapportées en émettant une exception de type Error, qui peut être attrapée par le gestionnaire. Les classes Error et Exception implémentent l'interface Throwable. Voici la signature du gestionnaire depuis PHP 7 :

void handler ( Throwable $ex )

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

Attention

Notez que le fait de fournir explicitement le type Exception pour le paramètre ex dans votre fonction de rappel peut avoir des incidences dans la hiérarchie des exceptions modifiées en PHP 7.

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
7.0.0	Le type du paramètre passé dans `exception_handler` a changé, passant de Exception à Throwable
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

Rechercher une fonction PHP

Version en cache

24/11/2024 23:11:52 Cette version de la page est en cache (à la date du 24/11/2024 23:11:52) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.set-exception-handler.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

Manuel PHP : http://php.net

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut