cvs: phpdoc-fr /reference/errorfunc reference.xml /reference/errorfunc/functions debug-backtrace.xml error-log.xml error-reporting.xml
set-error-handler.xml trigger-error.xml user-error.xml
| From: | Damien Seguy | Date: | Mon, 28 Apr 2003 15:47:59 +0000 |
| Subject: | cvs: phpdoc-fr /reference/errorfunc reference.xml /reference/errorfunc/functions debug-backtrace.xml error-log.xml error-reporting.xml set-error-handler.xml trigger-error.xml user-error.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-311@lists.php.net to get a copy of this message | ||
dams Mon Apr 28 11:47:59 2003 EDT
Added files:
/phpdoc-fr/reference/errorfunc/functions debug-backtrace.xml
Modified files:
/phpdoc-fr/reference/errorfunc reference.xml
/phpdoc-fr/reference/errorfunc/functions error-log.xml
error-reporting.xml
set-error-handler.xml
trigger-error.xml
user-error.xml
Log:
easy commit
Index: phpdoc-fr/reference/errorfunc/reference.xml diff -u phpdoc-fr/reference/errorfunc/reference.xml:1.2 phpdoc-fr/reference/errorfunc/reference.xml:1.3 --- phpdoc-fr/reference/errorfunc/reference.xml:1.2 Mon Apr 15 20:53:25 2002 +++ phpdoc-fr/reference/errorfunc/reference.xml Mon Apr 28 11:47:59 2003 @@ -1,10 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <reference id="ref.errorfunc"> <title>Gestion des erreurs</title> <titleabbrev>Gestion des erreurs</titleabbrev> - <partintro> - <para> + +<partintro> + <section id="errorfunc.intro"> + &reftitle.intro; + <para> 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 @@ -22,10 +25,35 @@ et le type d'erreur noté : depuis les inoffensives alertes jusqu'au erreurs personnalisées retournées par les fonctions. </para> - </partintro> -&reference.errorfunc.functions; + </section> + + <section id="errorfunc.requirements"> + &reftitle.required; + &no.requirement; + </section> + + <section id="errorfunc.installation"> + &reftitle.install; + &no.install; + </section> + + &reference.errorfunc.ini; + &reference.errorfunc.constants; + + &reference.errorfunc.examples; + + <section id="errorfunc.seealso"> + &reftitle.seealso; + <para> + Voir aussi <function>syslog</function>. + </para> + </section> + + </partintro> + +&reference.errorfunc.functions; </reference> <!-- Keep this comment at the end of the file Local variables: Index: phpdoc-fr/reference/errorfunc/functions/error-log.xml diff -u phpdoc-fr/reference/errorfunc/functions/error-log.xml:1.1 phpdoc-fr/reference/errorfunc/functions/error-log.xml:1.2 --- phpdoc-fr/reference/errorfunc/functions/error-log.xml:1.1 Sun Apr 14 20:27:06 2002 +++ phpdoc-fr/reference/errorfunc/functions/error-log.xml Mon Apr 28 11:47:59 2003 @@ -4,17 +4,17 @@ <refentry id="function.error-log"> <refnamediv> <refname>error_log</refname> - <refpurpose>Envoie un message d'erreur quelque part</refpurpose> + <refpurpose>Stocke un message d'erreur</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>error_log</methodname> - <methodparam><type>string</type><parameter>message</parameter></methodparam> - <methodparam><type>int</type><parameter>message_type</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>destination</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>extra_headers</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>int</type><methodname>error_log</methodname> + <methodparam><type>string</type><parameter>message</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>message_type</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>destination</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>extra_headers</parameter></methodparam> + </methodsynopsis> <para> <function>error_log</function> envoie un message d'erreur à l'historique du serveur web, à un port <acronym>TCP</acronym> ou un @@ -80,7 +80,8 @@ <example role="php"> <title>Exemples avec <function>error_log</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php // Envoi une notification par l'historique du serveur, si la connexion à la base // de données est impossible. if (!Ora_Logon ($username, $password)) { @@ -95,7 +96,8 @@ error_log ("Grosse bourde!", 2, "127.0.0.1:7000"); error_log ("Grosse bourde!", 2, "loghost"); error_log ("Grosse bourde!", 3, "/var/tmp/my-errors.log"); -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/errorfunc/functions/error-reporting.xml diff -u phpdoc-fr/reference/errorfunc/functions/error-reporting.xml:1.1 phpdoc-fr/reference/errorfunc/functions/error-reporting.xml:1.2 --- phpdoc-fr/reference/errorfunc/functions/error-reporting.xml:1.1 Sun Apr 14 20:27:06 2002 +++ phpdoc-fr/reference/errorfunc/functions/error-reporting.xml Mon Apr 28 11:47:59 2003 @@ -23,11 +23,18 @@ <example role="php"> <title>Exemple de modification de niveau d'erreur</title> <programlisting role="php"> -error_reporting (55); // En PHP 3, équivalent à E_ALL ^ E_NOTICE -/* ...en PHP 4, '55' signifie (E_ERROR | E_WARNING | E_PARSE | -E_CORE_ERROR | E_CORE_WARNING) */ -error_reporting (2039); // PHP 4 équivalent à E_ALL ^ E_NOTICE -error_reporting (E_ALL ^ E_NOTICE); // La même signification en PHP 3 et 4 +<![CDATA[ +<?php + error_reporting (55); +// En PHP 3, équivalent à E_ALL ^ E_NOTICE +// ...en PHP 4, '55' signifie (E_ERROR | E_WARNING | E_PARSE | E_CORE_ERROR | E_CORE_WARNING) + +error_reporting (2039); +// PHP 4 équivalent à E_ALL ^ E_NOTICE + +error_reporting (E_ALL ^ E_NOTICE); +// La même signification en PHP 3 et 4 +]]> </programlisting> </example> Suivez les liens de chaque valeur interne pour connaître leur signification : @@ -107,28 +114,20 @@ <link linkend="internal.e-user-error">E_USER_NOTICE</link> </entry> </row> - </tbody> + <row> + <entry>2047</entry> + <entry> + <link linkend="internal.e-all">E_ALL</link> + </entry> + </row> + </tbody> </tgroup> </table> </para> - <para> - <example role="php"> - <title>Exemples avec <function>error_reporting</function></title> - <programlisting role="php"> -error_reporting(0); -/* Empêche tout affichage d'erreur */ -error_reporting(7); // Ancienne syntaxe PHP 2/3 -error_reporting(E_ERROR | E_WARNING | E_PARSE); // Nouvelle syntaxe PHP 3/4 -/* Utilisation appropriée pour les erreurs courantes d'exécution */ -error_reporting(15); // Ancienne syntaxe, PHP 2/3 -error_reporting(E_ERROR | E_WARNING | E_PARSE | E_NOTICE); // Nouvelle syntaxe PHP 3/4 -/* Utilisation appropriée pour les erreurs courantes de développement - (variables non initialisées..)*/ -error_reporting(63); // Ancienne syntaxe, PHP 2/3 -error_reporting(E_ALL); // Nouvelle syntaxe PHP 3/4 -/* rapporte toutes les erreurs PHP*/ - </programlisting> - </example> + <para> + Voir aussi + la directive <link linkend="ini.display-errors">display_errors</link> + et <function>ini_set</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/errorfunc/functions/set-error-handler.xml diff -u phpdoc-fr/reference/errorfunc/functions/set-error-handler.xml:1.1 phpdoc-fr/reference/errorfunc/functions/set-error-handler.xml:1.2 --- phpdoc-fr/reference/errorfunc/functions/set-error-handler.xml:1.1 Sun Apr 14 20:27:07 2002 +++ phpdoc-fr/reference/errorfunc/functions/set-error-handler.xml Mon Apr 28 11:47:59 2003 @@ -12,7 +12,7 @@ <title>Description</title> <methodsynopsis> <type>string</type><methodname>set_error_handler</methodname> - <methodparam><type>string</type><parameter>error_handler</parameter></methodparam> + <methodparam><type>callback</type><parameter>error_handler</parameter></methodparam> </methodsynopsis> <para> <function>set_error_handler</function> choisit la fonction utilisateur @@ -30,112 +30,146 @@ La fonction utilisateur doit accepter deux arguments : le code de l'erreur, et une chaîne décrivant l'erreur. L'exemple ci dessous montre le traitement d'exceptions en déclenchant des erreurs, et en les - gérant avec une fonction utilisateur : + gérant avec une fonction utilisateur. + </para> + <note> + <simpara> + Au lieu d'un nom de fonction, vous pouvez utiliser un tableau contenant + deux éléments, une référence sur un objet et un nom de méthode. Cette + fonctionnalité a été ajoutée en PHP 4.3.0. + </simpara> + </note> + <note> + <para> + Les types d'erreur suivants ne peuvent pas être gérés avec cette fonction : + <constant>E_ERROR</constant>, <constant>E_PARSE</constant>, + <constant>E_CORE_ERROR</constant>, <constant>E_CORE_WARNING</constant>, + <constant>E_COMPILE_ERROR</constant> et + <constant>E_COMPILE_WARNING</constant>. + </para> + </note> + <para> + L'exemple ci-dessous illustre l'interception d'erreurs internes avec + génération d'erreur, et exploitation dans une fonction utilisateur : <example> <title> Traitement des erreurs avec <function>set_error_handler</function> et <function>trigger_error</function> </title> <programlisting role="php"> -<?php -// redéfinit les constantes utilisateurs - PHP 4 seulement -define (FATAL,E_USER_ERROR); -define (ERROR,E_USER_WARNING); -define (WARNING,E_USER_NOTICE); -// Fixe le niveau de rapport d'erreur pour ce script -error_reporting (FATAL + ERROR + WARNING); -// Fonction de traitement des erreurs -function myErrorHandler ($errno, $errstr) { - switch ($errno) { - case FATAL: - echo "<B>FATAL</B> [$errno] $errstr<br>\n"; - echo " Erreur fatale à la ligne ".__LINE__." du fichier ".__FILE__; - echo ", PHP ".PHP_VERSION." (".PHP_OS.")<br>\n"; - echo "Aborting...<br>\n"; - exit -1; +<![CDATA[ +<?php + +// redéfini les constantes utilisateur (PHP 4 Uniquement) +define ("FATAL",E_USER_ERROR); +define ("ERROR",E_USER_WARNING); +define ("WARNING",E_USER_NOTICE); + +// configure le niveau de rapport d'erreur pour ce script +error_reporting (FATAL | ERROR | WARNING); + +// gestionnaire d'erreurs +function myErrorHandler ($errno, $errstr, $errfile, $errline) { + switch ($errno) { + case FATAL: + echo "<b>FATAL</b> [$errno] $errstr<br>\n"; + echo " Fatal error in line ".$errline." of file ".$errfile; + echo ", PHP ".PHP_VERSION." (".PHP_OS.")<br>\n"; + echo "Aborting...<br>\n"; + exit(1); break; - case ERROR: - echo "<B>ERREUR</B> [$errno] $errstr<br>\n"; + case ERROR: + echo "<b>ERROR</b> [$errno] $errstr<br>\n"; break; - case WARNING: - echo "<B>ALERTE</B> [$errno] $errstr<br>\n"; + case WARNING: + echo "<b>WARNING</b> [$errno] $errstr<br>\n"; break; default: - echo "Erreur inconnue de type : [$errno] $errstr<br>\n"; + echo "Unkown error type: [$errno] $errstr<br>\n"; break; - } + } } -// fonction qui teste la gestion d'erreur + +// fonction pour tester la gestion d'erreur function scale_by_log ($vect, $scale) { - if ( !is_numeric($scale) || $scale <= 0 ) - trigger_error("log(x) pour x <= 0 est indéfini, vous avez passé: scale = $scale", + if ( !is_numeric($scale) || $scale <= 0 ) + trigger_error("log(x) for x <= 0 is undefined, you used: scale = $scale", FATAL); - if (!is_array($vect)) { - trigger_error("Vecteur d'entrée incorrect : un tableau de valeurs est attendu : ", ERROR); + if (!is_array($vect)) { + trigger_error("Incorrect input vector, array of values expected", ERROR); return null; - } - for ($i=0; $i<count($vect); $i++) { + } + for ($i=0; $i<count($vect); $i++) { if (!is_numeric($vect[$i])) - trigger_error("La valeur à la position $i n'est pas un nombre. On utilise 0 (zéro) à la place", - WARNING); + trigger_error("Value at position $i is not a number, using 0 (zero)", + WARNING); $temp[$i] = log($scale) * $vect[$i]; - } - return $temp; + } + return $temp; } -// Ancienne fonction de traitement des erreurs -$old_error_handler = set_error_handler("myErrorHandler"); -// Génération de quelques erreurs : définition d'un tableau avec des éléments non numériques -echo "vector a\n"; -$a = array(2,3,"foo",5.5,43.3,21.11); + +// 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 "vecteur a \n"; +$a = array(2,3,"foo",5.5,43.3,21.11); print_r($a); -// définition d'un deuxième table à problème -echo "----\nvector b - a alerte (b = log(PI) * a)\n"; + +// générons maintenant un autre tableau, avec des alertes +echo "----\nvecteur b - une alerte (b = log(PI) * a)\n"; $b = scale_by_log($a, M_PI); print_r($b); -// Ceci est un problème, on passe une chaîne à la place d'un tableau -echo "----\nvector c - une erreur\n"; -$c = scale_by_log("not array",2.3); + +// ceci est un problème, nous avons utilisé une chaîne au lieu d'un tableau +echo "----\nvecteur c - une erreur\n"; +$c = scale_by_log("not array",2.3); var_dump($c); -// Ceci est critique : le tableau contient des valeurs négatives -echo "----\nvector d - fatal error\n"; + +// Ceci est une erreur critique : le logarithme de zéro ou d'un nombre négatif est indéfini +echo "----\nvecteur d - erreur fatale\n"; $d = scale_by_log($a, -2.5); -?> + +?> +]]> </programlisting> </example> L'éxécution du script devrait donner ceci : <informalexample> <programlisting> -vector a +<![CDATA[ +vecteur a Array ( - [0] => 2 - [1] => 3 - [2] => foo - [3] => 5.5 - [4] => 43.3 - [5] => 21.11 + [0] => 2 + [1] => 3 + [2] => foo + [3] => 5.5 + [4] => 43.3 + [5] => 21.11 ) ---- -vector b - une alerte (b = log(PI) * a) -<B>WARNING</B> [1024] La valeur à la position 2 n'est pas un nombre. On utilise 0 (zéro) à la place<br> +vecteur b - une alerte (b = log(PI) * a) +<b>WARNING</b> [1024] Value at position 2 is not a number, using 0 (zero)<br> Array ( - [0] => 2.2894597716988 - [1] => 3.4341896575482 - [2] => 0 - [3] => 6.2960143721717 - [4] => 49.566804057279 - [5] => 24.165247890281 + [0] => 2.2894597716988 + [1] => 3.4341896575482 + [2] => 0 + [3] => 6.2960143721717 + [4] => 49.566804057279 + [5] => 24.165247890281 ) ---- -vector c - an error -<B>ERROR</B> [512] Vecteur d'entrée incorrect : un tableau de valeur est attendu<br> +vecteur c - une erreur +<b>ERROR</b> [512] Incorrect input vector, array of values expected<br> NULL ---- -vector d - fatal error -<B>FATAL</B> [256] log(x) de x <= 0 est indéfini : scale = -2.5<br> -Erreur fatale à la ligne 16 du fichier trigger_error.php, PHP 4.0.1pl2 (Linux)<br> -Annulation du script....<br> +vecteur d - erreur fatale +<b>FATAL</b> [256] log(x) for x <= 0 is undefined, you used: scale = -2.5<br> + Fatal error in line 37 of file /Users/imac/-, PHP 5.0.0-dev (Darwin)<br> +Aborting...<br> +]]> </programlisting> </informalexample> </para> @@ -157,6 +191,13 @@ fonction de gestion des erreurs se termine normalement, l'exécution du script se poursuivra avec l'exécution de la prochaine commande. </para> + <note> + <para> + 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és ne pourra + pas être appelé, car il n'est pas encore enregistré. + </para> + </note> <para> Voir aussi <function>error_reporting</function>, Index: phpdoc-fr/reference/errorfunc/functions/trigger-error.xml diff -u phpdoc-fr/reference/errorfunc/functions/trigger-error.xml:1.1 phpdoc-fr/reference/errorfunc/functions/trigger-error.xml:1.2 --- phpdoc-fr/reference/errorfunc/functions/trigger-error.xml:1.1 Sun Apr 14 20:27:07 2002 +++ phpdoc-fr/reference/errorfunc/functions/trigger-error.xml Mon Apr 28 11:47:59 2003 @@ -28,25 +28,33 @@ l'exécution. Par exemple : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php if (assert ($divisor == 0)) trigger_error ("Impossible de diviser par zéro", E_USER_ERROR); -?> +?> +]]> </programlisting> </informalexample> <note> <para> - Voir aussi - <function>set_error_handler</function> pour illustration. + Voir <function>set_error_handler</function> pour une illustration. </para> </note> + <note> + <para> + <parameter>error_msg</parameter> est limité à 1024 caractères + en longueur. Tous les caractères supplémentaires seront + ignorés. + </para> + </note> </para> - <para> - Voir aussi - <function>error_reporting</function>, - <function>set_error_handler</function>, - <function>restore_error_handler</function> et - <function>user_error</function> + <para> + Voir aussi + <function>error_reporting</function>, + <function>set_error_handler</function>, + <function>restore_error_handler</function> et + <function>user_error</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/errorfunc/functions/user-error.xml diff -u phpdoc-fr/reference/errorfunc/functions/user-error.xml:1.1 phpdoc-fr/reference/errorfunc/functions/user-error.xml:1.2 --- phpdoc-fr/reference/errorfunc/functions/user-error.xml:1.1 Sun Apr 14 20:27:08 2002 +++ phpdoc-fr/reference/errorfunc/functions/user-error.xml Mon Apr 28 11:47:59 2003 @@ -4,26 +4,12 @@ <refentry id="function.user-error"> <refnamediv> <refname>user_error</refname> - <refpurpose> - Génère un message d'erreur utilisateur - </refpurpose> + <refpurpose>Alias de <function>trigger_error</function></refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>void</type><methodname>user_error</methodname> - <methodparam><type>string</type><parameter>error_msg</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>error_type</parameter></methodparam> - </methodsynopsis> <para> - <function>user_error</function> est un alias de la fonction - <function>trigger_error</function>. - </para> - <para> - Voir aussi - <function>error_reporting</function>, - <function>set_error_handler</function>, - <function>restore_error_handler</function> et + <function>user_error</function> est un &alias; de la fonction <function>trigger_error</function>. </para> </refsect1> Index: phpdoc-fr/reference/errorfunc/functions/debug-backtrace.xml +++ phpdoc-fr/reference/errorfunc/functions/debug-backtrace.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.debug-backtrace"> <refnamediv> <refname>debug_backtrace</refname> <refpurpose>Génère le contexte de débogage</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>debug_backtrace</methodname> <void/> </methodsynopsis> <para> <function>debug_backtrace</function> génère un contexte de débogage et retourne cette information sous forme de tableau associatif (<type>array</type>). Les éléments de ce tableau sont les suivants : </para> <para> <table> <title>Eléments du tableau de <function>debug_backtrace</function></title> <tgroup cols="3"> <thead> <row> <entry>Nam</entry> <entry>Type</entry> <entry>Description</entry> </row> </thead> <tbody> <row> <entry>function</entry> <entry><type>string</type></entry> <entry> Le nom de la fonction courante. Voyez aussi <link linkend="language.constants.predefined">__FUNCTION__</link>. </entry> </row> <row> <entry>line</entry> <entry><type>integer</type></entry> <entry> Le numéro courant de ligne. Voyez aussi <link linkend="language.constants.predefined">__LINE__</link>. </entry> </row> <row> <entry>file</entry> <entry><type>string</type></entry> <entry> Le nom du fichier courant. Voyez aussi <link linkend="language.constants.predefined">__FILE__</link>. </entry> </row> <row> <entry>class</entry> <entry><type>string</type></entry> <entry> Le nom de la classe courante <link linkend="language.oop">class</link>. Voyez aussi <link linkend="language.constants.predefined">__CLASS__</link> </entry> </row> <row> <entry>type</entry> <entry><type>string</type></entry> <entry> Le type de classe courante. </entry> </row> <row> <entry>args</entry> <entry><type>array</type></entry> <entry> Si à l'intérieur d'une fonction, la liste des arguments. Si dans un fichier inclus, la liste des fichiers inclus. </entry> </row> </tbody> </tgroup> </table> </para> <para> Voici un exemple simple d'utilisation. </para> <para> <example> <title>Exemple avec <function>debug_backtrace</function></title> <programlisting role="php"> <![CDATA[ // premier fichier : a.php <?php function a_test($str) { print "\nBonjour : $str"; var_dump(debug_backtrace()); } a_test('ami'); ?> // second fichier : b.php <?php include_once '/tmp/a.php'; ?> /* Résultats lors de l'éxécution de /tmp/b.php Bonjour : ami array(2) { [0]=> array(4) { ["file"] => string(10) "/tmp/a.php" ["line"] => int(10) ["function"] => string(6) "a_test" ["args"]=> array(1) { [0] => &string(3) "ami" } } [1]=> array(4) { ["file"] => string(10) "/tmp/b.php" ["line"] => int(2) ["args"] => array(1) { [0] => string(10) "/tmp/a.php" } ["function"] => string(12) "include_once" } } */ ]]> </programlisting> </example> </para> <para> Voir aussi <function>trigger_error</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
Index: phpdoc-fr/reference/errorfunc/reference.xml diff -u phpdoc-fr/reference/errorfunc/reference.xml:1.2 phpdoc-fr/reference/errorfunc/reference.xml:1.3 --- phpdoc-fr/reference/errorfunc/reference.xml:1.2 Mon Apr 15 20:53:25 2002 +++ phpdoc-fr/reference/errorfunc/reference.xml Mon Apr 28 11:47:59 2003 @@ -1,10 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <reference id="ref.errorfunc"> <title>Gestion des erreurs</title> <titleabbrev>Gestion des erreurs</titleabbrev> - <partintro> - <para> + +<partintro> + <section id="errorfunc.intro"> + &reftitle.intro; + <para> 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 @@ -22,10 +25,35 @@ et le type d'erreur noté : depuis les inoffensives alertes jusqu'au erreurs personnalisées retournées par les fonctions. </para> - </partintro> -&reference.errorfunc.functions; + </section> + + <section id="errorfunc.requirements"> + &reftitle.required; + &no.requirement; + </section> + + <section id="errorfunc.installation"> + &reftitle.install; + &no.install; + </section> + + &reference.errorfunc.ini; + &reference.errorfunc.constants; + + &reference.errorfunc.examples; + + <section id="errorfunc.seealso"> + &reftitle.seealso; + <para> + Voir aussi <function>syslog</function>. + </para> + </section> + + </partintro> + +&reference.errorfunc.functions; </reference> <!-- Keep this comment at the end of the file Local variables: Index: phpdoc-fr/reference/errorfunc/functions/error-log.xml diff -u phpdoc-fr/reference/errorfunc/functions/error-log.xml:1.1 phpdoc-fr/reference/errorfunc/functions/error-log.xml:1.2 --- phpdoc-fr/reference/errorfunc/functions/error-log.xml:1.1 Sun Apr 14 20:27:06 2002 +++ phpdoc-fr/reference/errorfunc/functions/error-log.xml Mon Apr 28 11:47:59 2003 @@ -4,17 +4,17 @@ <refentry id="function.error-log"> <refnamediv> <refname>error_log</refname> - <refpurpose>Envoie un message d'erreur quelque part</refpurpose> + <refpurpose>Stocke un message d'erreur</refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>error_log</methodname> - <methodparam><type>string</type><parameter>message</parameter></methodparam> - <methodparam><type>int</type><parameter>message_type</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>destination</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>extra_headers</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>int</type><methodname>error_log</methodname> + <methodparam><type>string</type><parameter>message</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>message_type</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>destination</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>extra_headers</parameter></methodparam> + </methodsynopsis> <para> <function>error_log</function> envoie un message d'erreur à l'historique du serveur web, à un port <acronym>TCP</acronym> ou un @@ -80,7 +80,8 @@ <example role="php"> <title>Exemples avec <function>error_log</function></title> <programlisting role="php"> -<?php +<![CDATA[ +<?php // Envoi une notification par l'historique du serveur, si la connexion à la base // de données est impossible. if (!Ora_Logon ($username, $password)) { @@ -95,7 +96,8 @@ error_log ("Grosse bourde!", 2, "127.0.0.1:7000"); error_log ("Grosse bourde!", 2, "loghost"); error_log ("Grosse bourde!", 3, "/var/tmp/my-errors.log"); -?> +?> +]]> </programlisting> </example> </para> Index: phpdoc-fr/reference/errorfunc/functions/error-reporting.xml diff -u phpdoc-fr/reference/errorfunc/functions/error-reporting.xml:1.1 phpdoc-fr/reference/errorfunc/functions/error-reporting.xml:1.2 --- phpdoc-fr/reference/errorfunc/functions/error-reporting.xml:1.1 Sun Apr 14 20:27:06 2002 +++ phpdoc-fr/reference/errorfunc/functions/error-reporting.xml Mon Apr 28 11:47:59 2003 @@ -23,11 +23,18 @@ <example role="php"> <title>Exemple de modification de niveau d'erreur</title> <programlisting role="php"> -error_reporting (55); // En PHP 3, équivalent à E_ALL ^ E_NOTICE -/* ...en PHP 4, '55' signifie (E_ERROR | E_WARNING | E_PARSE | -E_CORE_ERROR | E_CORE_WARNING) */ -error_reporting (2039); // PHP 4 équivalent à E_ALL ^ E_NOTICE -error_reporting (E_ALL ^ E_NOTICE); // La même signification en PHP 3 et 4 +<![CDATA[ +<?php + error_reporting (55); +// En PHP 3, équivalent à E_ALL ^ E_NOTICE +// ...en PHP 4, '55' signifie (E_ERROR | E_WARNING | E_PARSE | E_CORE_ERROR | E_CORE_WARNING) + +error_reporting (2039); +// PHP 4 équivalent à E_ALL ^ E_NOTICE + +error_reporting (E_ALL ^ E_NOTICE); +// La même signification en PHP 3 et 4 +]]> </programlisting> </example> Suivez les liens de chaque valeur interne pour connaître leur signification : @@ -107,28 +114,20 @@ <link linkend="internal.e-user-error">E_USER_NOTICE</link> </entry> </row> - </tbody> + <row> + <entry>2047</entry> + <entry> + <link linkend="internal.e-all">E_ALL</link> + </entry> + </row> + </tbody> </tgroup> </table> </para> - <para> - <example role="php"> - <title>Exemples avec <function>error_reporting</function></title> - <programlisting role="php"> -error_reporting(0); -/* Empêche tout affichage d'erreur */ -error_reporting(7); // Ancienne syntaxe PHP 2/3 -error_reporting(E_ERROR | E_WARNING | E_PARSE); // Nouvelle syntaxe PHP 3/4 -/* Utilisation appropriée pour les erreurs courantes d'exécution */ -error_reporting(15); // Ancienne syntaxe, PHP 2/3 -error_reporting(E_ERROR | E_WARNING | E_PARSE | E_NOTICE); // Nouvelle syntaxe PHP 3/4 -/* Utilisation appropriée pour les erreurs courantes de développement - (variables non initialisées..)*/ -error_reporting(63); // Ancienne syntaxe, PHP 2/3 -error_reporting(E_ALL); // Nouvelle syntaxe PHP 3/4 -/* rapporte toutes les erreurs PHP*/ - </programlisting> - </example> + <para> + Voir aussi + la directive <link linkend="ini.display-errors">display_errors</link> + et <function>ini_set</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/errorfunc/functions/set-error-handler.xml diff -u phpdoc-fr/reference/errorfunc/functions/set-error-handler.xml:1.1 phpdoc-fr/reference/errorfunc/functions/set-error-handler.xml:1.2 --- phpdoc-fr/reference/errorfunc/functions/set-error-handler.xml:1.1 Sun Apr 14 20:27:07 2002 +++ phpdoc-fr/reference/errorfunc/functions/set-error-handler.xml Mon Apr 28 11:47:59 2003 @@ -12,7 +12,7 @@ <title>Description</title> <methodsynopsis> <type>string</type><methodname>set_error_handler</methodname> - <methodparam><type>string</type><parameter>error_handler</parameter></methodparam> + <methodparam><type>callback</type><parameter>error_handler</parameter></methodparam> </methodsynopsis> <para> <function>set_error_handler</function> choisit la fonction utilisateur @@ -30,112 +30,146 @@ La fonction utilisateur doit accepter deux arguments : le code de l'erreur, et une chaîne décrivant l'erreur. L'exemple ci dessous montre le traitement d'exceptions en déclenchant des erreurs, et en les - gérant avec une fonction utilisateur : + gérant avec une fonction utilisateur. + </para> + <note> + <simpara> + Au lieu d'un nom de fonction, vous pouvez utiliser un tableau contenant + deux éléments, une référence sur un objet et un nom de méthode. Cette + fonctionnalité a été ajoutée en PHP 4.3.0. + </simpara> + </note> + <note> + <para> + Les types d'erreur suivants ne peuvent pas être gérés avec cette fonction : + <constant>E_ERROR</constant>, <constant>E_PARSE</constant>, + <constant>E_CORE_ERROR</constant>, <constant>E_CORE_WARNING</constant>, + <constant>E_COMPILE_ERROR</constant> et + <constant>E_COMPILE_WARNING</constant>. + </para> + </note> + <para> + L'exemple ci-dessous illustre l'interception d'erreurs internes avec + génération d'erreur, et exploitation dans une fonction utilisateur : <example> <title> Traitement des erreurs avec <function>set_error_handler</function> et <function>trigger_error</function> </title> <programlisting role="php"> -<?php -// redéfinit les constantes utilisateurs - PHP 4 seulement -define (FATAL,E_USER_ERROR); -define (ERROR,E_USER_WARNING); -define (WARNING,E_USER_NOTICE); -// Fixe le niveau de rapport d'erreur pour ce script -error_reporting (FATAL + ERROR + WARNING); -// Fonction de traitement des erreurs -function myErrorHandler ($errno, $errstr) { - switch ($errno) { - case FATAL: - echo "<B>FATAL</B> [$errno] $errstr<br>\n"; - echo " Erreur fatale à la ligne ".__LINE__." du fichier ".__FILE__; - echo ", PHP ".PHP_VERSION." (".PHP_OS.")<br>\n"; - echo "Aborting...<br>\n"; - exit -1; +<![CDATA[ +<?php + +// redéfini les constantes utilisateur (PHP 4 Uniquement) +define ("FATAL",E_USER_ERROR); +define ("ERROR",E_USER_WARNING); +define ("WARNING",E_USER_NOTICE); + +// configure le niveau de rapport d'erreur pour ce script +error_reporting (FATAL | ERROR | WARNING); + +// gestionnaire d'erreurs +function myErrorHandler ($errno, $errstr, $errfile, $errline) { + switch ($errno) { + case FATAL: + echo "<b>FATAL</b> [$errno] $errstr<br>\n"; + echo " Fatal error in line ".$errline." of file ".$errfile; + echo ", PHP ".PHP_VERSION." (".PHP_OS.")<br>\n"; + echo "Aborting...<br>\n"; + exit(1); break; - case ERROR: - echo "<B>ERREUR</B> [$errno] $errstr<br>\n"; + case ERROR: + echo "<b>ERROR</b> [$errno] $errstr<br>\n"; break; - case WARNING: - echo "<B>ALERTE</B> [$errno] $errstr<br>\n"; + case WARNING: + echo "<b>WARNING</b> [$errno] $errstr<br>\n"; break; default: - echo "Erreur inconnue de type : [$errno] $errstr<br>\n"; + echo "Unkown error type: [$errno] $errstr<br>\n"; break; - } + } } -// fonction qui teste la gestion d'erreur + +// fonction pour tester la gestion d'erreur function scale_by_log ($vect, $scale) { - if ( !is_numeric($scale) || $scale <= 0 ) - trigger_error("log(x) pour x <= 0 est indéfini, vous avez passé: scale = $scale", + if ( !is_numeric($scale) || $scale <= 0 ) + trigger_error("log(x) for x <= 0 is undefined, you used: scale = $scale", FATAL); - if (!is_array($vect)) { - trigger_error("Vecteur d'entrée incorrect : un tableau de valeurs est attendu : ", ERROR); + if (!is_array($vect)) { + trigger_error("Incorrect input vector, array of values expected", ERROR); return null; - } - for ($i=0; $i<count($vect); $i++) { + } + for ($i=0; $i<count($vect); $i++) { if (!is_numeric($vect[$i])) - trigger_error("La valeur à la position $i n'est pas un nombre. On utilise 0 (zéro) à la place", - WARNING); + trigger_error("Value at position $i is not a number, using 0 (zero)", + WARNING); $temp[$i] = log($scale) * $vect[$i]; - } - return $temp; + } + return $temp; } -// Ancienne fonction de traitement des erreurs -$old_error_handler = set_error_handler("myErrorHandler"); -// Génération de quelques erreurs : définition d'un tableau avec des éléments non numériques -echo "vector a\n"; -$a = array(2,3,"foo",5.5,43.3,21.11); + +// 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 "vecteur a \n"; +$a = array(2,3,"foo",5.5,43.3,21.11); print_r($a); -// définition d'un deuxième table à problème -echo "----\nvector b - a alerte (b = log(PI) * a)\n"; + +// générons maintenant un autre tableau, avec des alertes +echo "----\nvecteur b - une alerte (b = log(PI) * a)\n"; $b = scale_by_log($a, M_PI); print_r($b); -// Ceci est un problème, on passe une chaîne à la place d'un tableau -echo "----\nvector c - une erreur\n"; -$c = scale_by_log("not array",2.3); + +// ceci est un problème, nous avons utilisé une chaîne au lieu d'un tableau +echo "----\nvecteur c - une erreur\n"; +$c = scale_by_log("not array",2.3); var_dump($c); -// Ceci est critique : le tableau contient des valeurs négatives -echo "----\nvector d - fatal error\n"; + +// Ceci est une erreur critique : le logarithme de zéro ou d'un nombre négatif est indéfini +echo "----\nvecteur d - erreur fatale\n"; $d = scale_by_log($a, -2.5); -?> + +?> +]]> </programlisting> </example> L'éxécution du script devrait donner ceci : <informalexample> <programlisting> -vector a +<![CDATA[ +vecteur a Array ( - [0] => 2 - [1] => 3 - [2] => foo - [3] => 5.5 - [4] => 43.3 - [5] => 21.11 + [0] => 2 + [1] => 3 + [2] => foo + [3] => 5.5 + [4] => 43.3 + [5] => 21.11 ) ---- -vector b - une alerte (b = log(PI) * a) -<B>WARNING</B> [1024] La valeur à la position 2 n'est pas un nombre. On utilise 0 (zéro) à la place<br> +vecteur b - une alerte (b = log(PI) * a) +<b>WARNING</b> [1024] Value at position 2 is not a number, using 0 (zero)<br> Array ( - [0] => 2.2894597716988 - [1] => 3.4341896575482 - [2] => 0 - [3] => 6.2960143721717 - [4] => 49.566804057279 - [5] => 24.165247890281 + [0] => 2.2894597716988 + [1] => 3.4341896575482 + [2] => 0 + [3] => 6.2960143721717 + [4] => 49.566804057279 + [5] => 24.165247890281 ) ---- -vector c - an error -<B>ERROR</B> [512] Vecteur d'entrée incorrect : un tableau de valeur est attendu<br> +vecteur c - une erreur +<b>ERROR</b> [512] Incorrect input vector, array of values expected<br> NULL ---- -vector d - fatal error -<B>FATAL</B> [256] log(x) de x <= 0 est indéfini : scale = -2.5<br> -Erreur fatale à la ligne 16 du fichier trigger_error.php, PHP 4.0.1pl2 (Linux)<br> -Annulation du script....<br> +vecteur d - erreur fatale +<b>FATAL</b> [256] log(x) for x <= 0 is undefined, you used: scale = -2.5<br> + Fatal error in line 37 of file /Users/imac/-, PHP 5.0.0-dev (Darwin)<br> +Aborting...<br> +]]> </programlisting> </informalexample> </para> @@ -157,6 +191,13 @@ fonction de gestion des erreurs se termine normalement, l'exécution du script se poursuivra avec l'exécution de la prochaine commande. </para> + <note> + <para> + 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és ne pourra + pas être appelé, car il n'est pas encore enregistré. + </para> + </note> <para> Voir aussi <function>error_reporting</function>, Index: phpdoc-fr/reference/errorfunc/functions/trigger-error.xml diff -u phpdoc-fr/reference/errorfunc/functions/trigger-error.xml:1.1 phpdoc-fr/reference/errorfunc/functions/trigger-error.xml:1.2 --- phpdoc-fr/reference/errorfunc/functions/trigger-error.xml:1.1 Sun Apr 14 20:27:07 2002 +++ phpdoc-fr/reference/errorfunc/functions/trigger-error.xml Mon Apr 28 11:47:59 2003 @@ -28,25 +28,33 @@ l'exécution. Par exemple : <informalexample> <programlisting role="php"> -<?php +<![CDATA[ +<?php if (assert ($divisor == 0)) trigger_error ("Impossible de diviser par zéro", E_USER_ERROR); -?> +?> +]]> </programlisting> </informalexample> <note> <para> - Voir aussi - <function>set_error_handler</function> pour illustration. + Voir <function>set_error_handler</function> pour une illustration. </para> </note> + <note> + <para> + <parameter>error_msg</parameter> est limité à 1024 caractères + en longueur. Tous les caractères supplémentaires seront + ignorés. + </para> + </note> </para> - <para> - Voir aussi - <function>error_reporting</function>, - <function>set_error_handler</function>, - <function>restore_error_handler</function> et - <function>user_error</function> + <para> + Voir aussi + <function>error_reporting</function>, + <function>set_error_handler</function>, + <function>restore_error_handler</function> et + <function>user_error</function>. </para> </refsect1> </refentry> Index: phpdoc-fr/reference/errorfunc/functions/user-error.xml diff -u phpdoc-fr/reference/errorfunc/functions/user-error.xml:1.1 phpdoc-fr/reference/errorfunc/functions/user-error.xml:1.2 --- phpdoc-fr/reference/errorfunc/functions/user-error.xml:1.1 Sun Apr 14 20:27:08 2002 +++ phpdoc-fr/reference/errorfunc/functions/user-error.xml Mon Apr 28 11:47:59 2003 @@ -4,26 +4,12 @@ <refentry id="function.user-error"> <refnamediv> <refname>user_error</refname> - <refpurpose> - Génère un message d'erreur utilisateur - </refpurpose> + <refpurpose>Alias de <function>trigger_error</function></refpurpose> </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>void</type><methodname>user_error</methodname> - <methodparam><type>string</type><parameter>error_msg</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>error_type</parameter></methodparam> - </methodsynopsis> <para> - <function>user_error</function> est un alias de la fonction - <function>trigger_error</function>. - </para> - <para> - Voir aussi - <function>error_reporting</function>, - <function>set_error_handler</function>, - <function>restore_error_handler</function> et + <function>user_error</function> est un &alias; de la fonction <function>trigger_error</function>. </para> </refsect1> Index: phpdoc-fr/reference/errorfunc/functions/debug-backtrace.xml +++ phpdoc-fr/reference/errorfunc/functions/debug-backtrace.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <refentry id="function.debug-backtrace"> <refnamediv> <refname>debug_backtrace</refname> <refpurpose>Génère le contexte de débogage</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>array</type><methodname>debug_backtrace</methodname> <void/> </methodsynopsis> <para> <function>debug_backtrace</function> génère un contexte de débogage et retourne cette information sous forme de tableau associatif (<type>array</type>). Les éléments de ce tableau sont les suivants : </para> <para> <table> <title>Eléments du tableau de <function>debug_backtrace</function></title> <tgroup cols="3"> <thead> <row> <entry>Nam</entry> <entry>Type</entry> <entry>Description</entry> </row> </thead> <tbody> <row> <entry>function</entry> <entry><type>string</type></entry> <entry> Le nom de la fonction courante. Voyez aussi <link linkend="language.constants.predefined">__FUNCTION__</link>. </entry> </row> <row> <entry>line</entry> <entry><type>integer</type></entry> <entry> Le numéro courant de ligne. Voyez aussi <link linkend="language.constants.predefined">__LINE__</link>. </entry> </row> <row> <entry>file</entry> <entry><type>string</type></entry> <entry> Le nom du fichier courant. Voyez aussi <link linkend="language.constants.predefined">__FILE__</link>. </entry> </row> <row> <entry>class</entry> <entry><type>string</type></entry> <entry> Le nom de la classe courante <link linkend="language.oop">class</link>. Voyez aussi <link linkend="language.constants.predefined">__CLASS__</link> </entry> </row> <row> <entry>type</entry> <entry><type>string</type></entry> <entry> Le type de classe courante. </entry> </row> <row> <entry>args</entry> <entry><type>array</type></entry> <entry> Si à l'intérieur d'une fonction, la liste des arguments. Si dans un fichier inclus, la liste des fichiers inclus. </entry> </row> </tbody> </tgroup> </table> </para> <para> Voici un exemple simple d'utilisation. </para> <para> <example> <title>Exemple avec <function>debug_backtrace</function></title> <programlisting role="php"> <![CDATA[ // premier fichier : a.php <?php function a_test($str) { print "\nBonjour : $str"; var_dump(debug_backtrace()); } a_test('ami'); ?> // second fichier : b.php <?php include_once '/tmp/a.php'; ?> /* Résultats lors de l'éxécution de /tmp/b.php Bonjour : ami array(2) { [0]=> array(4) { ["file"] => string(10) "/tmp/a.php" ["line"] => int(10) ["function"] => string(6) "a_test" ["args"]=> array(1) { [0] => &string(3) "ami" } } [1]=> array(4) { ["file"] => string(10) "/tmp/b.php" ["line"] => int(2) ["args"] => array(1) { [0] => string(10) "/tmp/a.php" } ["function"] => string(12) "include_once" } } */ ]]> </programlisting> </example> </para> <para> Voir aussi <function>trigger_error</function>. </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->