set_error_handler

(PHP 4 >= 4.0.1, PHP 5)

set_error_handler -- Spécifie une fonction utilisateur comme gestionnaire d'erreurs

Description

mixed set_error_handler ( callback error_handler [, int error_types] )

set_error_handler() choisit la fonction utilisateur error_handler pour gérer les erreurs dans un script.

set_error_handler() peut être utilisé pour définir votre propre manière de gérer les erreurs durant l'exécution, par exemple pour une application dans laquelle vous devez nettoyer les données/fichiers lorsqu'une erreur survient ou lorsque vous devez déclencher une erreur sous certaines conditions (en utilisant trigger_error()).

Il faut se rappeler que la fonction standard de traitement des erreurs de PHP est alors complètement ignorée. error_reporting() n'aura plus d'effet, et votre fonction de gestion des erreurs sera toujours appelée. Vous pourrez toujours lire la valeur de l'erreur courante de error_reporting et faire réagir la fonction de gestion des erreurs en fonction. Cette remarque est notamment valable si la commande a été préfixée par @.

Notez aussi qu'il est alors confié à cette fonction de terminer le script (die()) si nécessaire. Si la fonction de gestion des erreurs se termine normalement, l'exécution du script se poursuivra avec l'exécution de la prochaine commande.

Les types d'erreur suivants ne peuvent pas être gérés avec cette fonction : E_ERROR, E_PARSE, E_CORE_ERROR, E_CORE_WARNING, E_COMPILE_ERROR, E_COMPILE_WARNING ainsi que la plupart des E_STRICT d'un fichier lorsque set_error_handler() est appelé.

Si une erreur survient avant que le script ne soit exécuté (par exemple un téléchargement de fichier), le gestionnaire d'erreurs personnalisé ne pourra pas être appelé, car il n'est pas encore enregistré.

Liste de paramètres

error_handler

La fonction utilisateur doit accepter deux paramètres : le code d'erreur et une chaîne décrivant le code d'erreur. Depuis, trois paramètres optionnels sont fournis en même temps : le fichier dans lequel l'erreur est survenue, la ligne à laquelle l'erreur est survenue, et le contexte dans lequel l'erreu est survenue (un tableau contenant la liste des symboles lors de l'erreur). La fonction peut être décrite comme ceci :

handler ( int errno, string errstr [, string errfile [, int errline [, array errcontext]]] )

errno: Le premier paramètre errno, contient le niveau d'erreur, sous la forme d'un entier.
errstr: Le second paramètre errstr, contient le message d'erreur, sous forme de chaîne.
errfile: Le troisième paramètre, optionnel, errfile, contient le nom du fichier dans lequel l'erreur a été identifiée.
errline: Le quatrième paramètre, optionnel, errline, contient le numéro de ligne à laquelle l'erreur a été identifiée.
errcontext: Le cinquième paramètre, optionnel, errcontext, est un tableau qui pointe sur la table des symboles actifs lors de l'erreur. En d'autres termes, errcontext contient un tableau avec toutes les variables qui existaient lorsque l'erreur a été déclenchée. La fonction de gestion d'erreurs de l'utilisateur ne doit pas modifier le contexte d'erreur.

error_types

Sert de masque pour appeler la fonction error_handler de la même façon que l'option de configuration error_reporting contrôle les erreurs qui sont affichées. Sans le masque, error_handler sera appelé pour toutes les erreurs, quelque soit la valeur de error_reporting.

Valeurs de retour

Retourne une chaîne de caractères contenant le dernier gestionnaire d'erreurs (si il y en avait un) ou NULL en cas d'erreur. Si l'ancien gestionnaire d'erreurs était une méthode d'une classe, cette fonction retournera un tableau indexé avec les noms de la classe et de la méthode.

Historique

Version	Description
5.0.0	Le paramètre `error_types` a été introduit.
4.3.0	Au lieu d'un nom de fonction, un tableau contenant une référence à un objet ainsi qu'un nom de méthode peut aussi être passé au paramètre `error_handler`.
4.0.2	Trois paramètres optionnels pour le paramètre `error_handler` de la fonction utilisateur ont été introduits. C'est le nom du fichier, le numéro de ligne ainsi que le contexte.

Exemples

Exemple 1. Gestionnaire d'erreurs avec set_error_handler() et trigger_error()

L'exemple ci-dessous illustre l'interception d'erreurs internes avec génération d'erreur et son exploitation dans une fonction utilisateur :


<?php

// Configure le niveau de rapport d'erreur pour ce script

error_reporting(E_USER_ERROR | E_USER_WARNING | E_USER_NOTICE);



// Gestionnaire d'erreurs

function myErrorHandler($errno, $errstr, $errfile, $errline)

{

  switch ($errno) {

  case E_USER_ERROR:

    echo "<b>Mon ERREUR</b> [$errno] $errstr<br />\n";

    echo "  Erreur fatale à la ligne $errline dans le fichier $errfile";

    echo ", PHP " . PHP_VERSION . " (" . PHP_OS . ")<br />\n";

    echo "Abandon...<br />\n";

    exit(1);

    break;

  case E_USER_WARNING:

    echo "<b>Mon ALERTE</b> [$errno] $errstr<br />\n";

    break;

  case E_USER_NOTICE:

    echo "<b>Ma NOTICE</b> [$errno] $errstr<br />\n";

    break;

  default:

    echo "Type d'erreur inconnu : [$errno] $errstr<br />\n";

    break;

  }

}



// Fonction pour tester la gestion d'erreur

function scale_by_log($vect, $scale)

{

  if (!is_numeric($scale) || $scale <= 0) {

    trigger_error("log(x) for x <= 0 est indéfini, vous utilisez : scale = $scale", E_USER_ERROR);

  }



  if (!is_array($vect)) {

    trigger_error("Entrée incorrect, tableau de valeurs attendu", E_USER_WARNING);

    return null;

  }



  for ($i=0; $i<count($vect); $i++) {

    if (!is_numeric($vect[$i]))

      trigger_error("La valeur à la position $i n'est pas un nombre, utilisation de 0 (zéro)", E_USER_NOTICE);

      $temp[$i] = log($scale) * $vect[$i];

    }

    return $temp;

  }



// Configuration du gestionnaire d'erreurs

$old_error_handler = set_error_handler("myErrorHandler");



// Génération de quelques erreurs. Commençons par créer un tableau

echo "vector a\n";

$a = array(2,3, "foo", 5.5, 43.3, 21.11);

print_r($a);



// Générons maintenant un autre tableau, avec des alertes

echo "----\nvector b - a warning (b = log(PI) * a)\n";

$b = scale_by_log($a, M_PI);

print_r($b);



// Ceci est un problème, nous avons utilisé une chaîne au lieu d'un tableau

echo "----\nvector c - an error\n";

$c = scale_by_log("not array", 2.3);

var_dump($c);



// Ceci est une erreur critique : le logarithme de zéro ou d'un nombre négatif est indéfini

echo "----\nvector d - fatal error\n";

$d = scale_by_log($a, -2.5);



?>

L'exemple ci-dessus va afficher quelque chose de similaire à :

vector a
Array
(
    [0] => 2
    [1] => 3
    [2] => foo
    [3] => 5.5
    [4] => 43.3
    [5] => 21.11
)
----
vector b - a warning (b = log(PI) * a)
<b>Mon ALERTE</b> [1024] La valeur à la position 2 n'est pas un nombre, utilisation de 0 (zéro)<br />
Array
(
    [0] => 2.2894597716988
    [1] => 3.4341896575482
    [2] => 0
    [3] => 6.2960143721717
    [4] => 49.566804057279
    [5] => 24.165247890281
)
----
vector c - an error
<b>Mon ERREUR</b> [512] Entrée incorrect, tableau de valeurs attendu<br />
NULL
----
vector d - fatal error
<b>Mon ERREUR FATALE</b> [256] log(x) for x <= 0 est indéfini, vous utilisez : scale = -2.5<br />
Erreur fatale à la ligne 36 dans le fichier trigger_error.php, PHP 4.0.2 (Linux)<br />
Abandon...<br />

Voir aussi

error_reporting()

restore_error_handler()

trigger_error()

error level constants

information à propos de callback type

Rechercher une fonction PHP

<- settype set_exception_handler ->

Réseaux sociaux

|Plus d'options...

Vous pouvez modifier vos préférences dans votre profil pour ne plus afficher les interactions avec les réseaux sociaux sur ces pages.

Nuage de mots clés

5 mots clés dont 0 définis manuellement (plus d'information...).

Avertissement

Cette page ne possède pas encore de mots clés manuels, ceci est donc un exemple automatique (les niveaux de pertinence sont fictifs, mais les liens sont valables). Pour tester le nuage avec une page qui contient des mots définis manuellement, vous pouvez cliquer ici.

Vous pouvez modifier vos préférences dans votre profil pour ne plus afficher le nuage de mots clés.

Références

Manuel PHP : http://be2.php.net, set_error_handler

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.

Structure du document

Réseaux sociaux
Nuage de mots clés
- Avertissement :
Références

Astuce pour imprimer les couleurs des cellules de tableaux : http://www.gaudry.be/ast-rf-450.html

Aucun commentaire pour cette page

tection. Enregistrement IDDN n° 5329-1006
Document créé le 22/08/06 00:32, dernière modification le Vendredi 17 Juin 2011, 12:12
Source du document imprimé : http://www.gaudry.be/php-rf-function.set-error-handler.html Document affiché 1 fois ce mois de Juin.
St.Gaudry©07.01.02

Outils (masquer)

Recherche (afficher)

Utilisateur (masquer)

Nouveaux :
S'enregistrer

Liste des Membres

Qui est en ligne?
FAQ du forum

FAQ

Navigation (masquer)

Navigation
Services
Le site
Materiel informatique
Generalites Informatique
Generalites OS
Systemes d'exploitation
UNIX - Linux
Windows NT
Windows 2000
Programmes
Office
VBA - VBS
Generalites reseau
Normes et standards
Modele OSI
Stat - Proba
Logique
Matrices
Graphes
Analyse
SGBD
Cryptologie
Compilateurs
Programmer
Programmation declarative
Java
API Java
C & C++
C Sharp
Visual Studio
.NET
SGML HTML XML
CSS
Optimisation Web
Fun Web
PHP - MySQL
Manuel PHP
- Lettre A
- Lettre B
- Lettre C
- Lettre D
- Lettre E
- Lettre F
- Lettre G
- Lettre H
- Lettre I
- Lettre J
- Lettre K
- Lettre L
- Lettre M
- Lettre N
- Lettre O
- Lettre P
- Lettre Q
- Lettre R
Le Web en vrac
Introduction au JavaScript
Objets JavaScript
JavaScript en vrac
Le brol du brol
Glossaire
Divertissement

Apparence (afficher)

Stats (afficher)

15832 documents
452 astuces.
549 niouzes.
3099 definitions.
447 membres.
8115 messages.

Document genere en :
0,30 seconde

Mises à jour :

Citation (masquer)

Compter en octal, c’est comme compter en décimal, si on n’utilise pas ses pouces

Tom Lehrer

Nous sommes le Dimanche 03 Juin 2012, 06:56, toutes les heures sont au format GMT+1.00 Heure, heure d'été (+1)