Introduction

Ces fonctions permettent de gérer les erreurs et de les enregistrer. Vous pouvez définir les règles de traitement des erreurs et choisir la manière de les enregistrer : vous pouvez adapter le rapport d'erreurs à vos besoins.

Avec les fonctions d'enregistrements, vous pouvez envoyer directement les rapports à d'autres machines (ou même les envoyer par email à un pager), à l'historique système, ou encore sélectionner les erreurs les plus importantes et ne pas enregistrer les autres.

La fonction de niveau d'erreur vous permet de personnaliser le niveau et le type d'erreur noté : depuis les inoffensives alertes jusqu'aux erreurs personnalisées retournées par les fonctions.

Pré-requis

Ces fonctions sont disponibles dans le module PHP standard, qui est toujours accessible.

Installation

Il n'y pas d'installation nécessaire pour utiliser ces fonctions, elles font parties du coeur de PHP.

Configuration à l'exécution

Le comportement de ces fonctions est affecté par la configuration dans le fichier php.ini.

Voici un éclaircissement sur l'utilisation des directives de configuration.

Constantes pré-définies

Les constantes listées ici sont toujours disponibles dans PHP.

Les valeurs ci-dessus (numérique ou symbolique) sont utilisées pour constituer des champs de bits, qui spécifient le niveau de rapport d'erreur. Vous pouvez utiliser les opérateurs de bits pour combiner ces valeurs pour en faire des masques qui filtrent certaines erreurs. Notez bien que seuls '|', '~', '!', '^' et '&' seront compris dans le fichier php.ini, et que aucun opérateur logique ne sera compris en php3.ini.

Exemples

Ci-dessous, vous trouverez un exemple de gestion des erreurs par PHP. Il y est défini un gestionnaire d'erreur, qui enregistre les informations dans un fichier (au format XML), et envoie un courriel au développeur si l'erreur est critique.

Exemple 1. Gestion d'erreurs avancées en PHP <?php // Nous allons faire notre propre gestion error_reporting(0); // Fonction spéciale de gestion des erreurs function userErrorHandler($errno, $errmsg, $filename, $linenum, $vars) {     // Date et heure de l'erreur     $dt = date("Y-m-d H:i:s (T)");     // Définit un tableau associatif avec les chaînes d'erreur     // En fait, les seuls niveaux qui nous interessent     // sont E_WARNING, E_NOTICE, E_USER_ERROR,     // E_USER_WARNING et E_USER_NOTICE     $errortype = array (                 E_ERROR           => "Erreur",                 E_WARNING         => "Alerte",                 E_PARSE           => "Erreur d'analyse",                 E_NOTICE          => "Note",                 E_CORE_ERROR      => "Core Error",                 E_CORE_WARNING    => "Core Warning",                 E_COMPILE_ERROR   => "Compile Error",                 E_COMPILE_WARNING => "Compile Warning",                 E_USER_ERROR      => "Erreur spécifique",                 E_USER_WARNING    => "Alerte spécifique",                 E_USER_NOTICE     => "Note spécifique",                 E_STRICT          => "Runtime Notice"                 );     // Les niveaux qui seront enregistrés     $user_errors = array(E_USER_ERROR, E_USER_WARNING, E_USER_NOTICE);          $err = "<errorentry>\n";     $err .= "\t<datetime>" . $dt . "</datetime>\n";     $err .= "\t<errornum>" . $errno . "</errornum>\n";     $err .= "\t<errortype>" . $errortype[$errno] . "</errortype>\n";     $err .= "\t<errormsg>" . $errmsg . "</errormsg>\n";     $err .= "\t<scriptname>" . $filename . "</scriptname>\n";     $err .= "\t<scriptlinenum>" . $linenum . "</scriptlinenum>\n";     if (in_array($errno, $user_errors)) {         $err .= "\t<vartrace>".wddx_serialize_value($vars,"Variables")."</vartrace>\n";     }     $err .= "</errorentry>\n\n";          // sauvegarde de l'erreur, et mail si c'est critique     error_log($err, 3, "/usr/local/php4/error.log");     if ($errno == E_USER_ERROR) {         mail("phpdev@example.com","Critical User Error",$err);     } } function distance($vect1, $vect2) {     if (!is_array($vect1) || !is_array($vect2)) {         trigger_error("Incorrect parameters, arrays expected", E_USER_ERROR);         return NULL;     }     if (count($vect1) != count($vect2)) {         trigger_error("Vectors need to be of the same size", E_USER_ERROR);         return NULL;     }     for ($i=0; $i<count($vect1); $i++) {         $c1 = $vect1[$i]; $c2 = $vect2[$i];         $d = 0.0;         if (!is_numeric($c1)) {             trigger_error("Coordinate $i in vector 1 is not a number, using zero",                             E_USER_WARNING);             $c1 = 0.0;         }         if (!is_numeric($c2)) {             trigger_error("Coordinate $i in vector 2 is not a number, using zero",                             E_USER_WARNING);             $c2 = 0.0;         }         $d += $c2*$c2 - $c1*$c1;     }     return sqrt($d); } $old_error_handler = set_error_handler("userErrorHandler"); // constante non définie, qui génère une alerte $t = I_AM_NOT_DEFINED; // définition de quelques vecteurs $a = array (2, 3, "foo"); $b = array (5.5, 4.3, -1.6); $c = array (1, -3); // génère une erreur utilisateur $t1 = distance ($c, $b)."\n"; // génère une erreur utilisateur $t2 = distance ($b, "i am not an array")."\n"; // Génère une alerte $t3 = distance ($a, $b)."\n"; ?>

Voir aussi

Voir aussi syslog().