dams Fri Nov 2 04:15:47 2001 EDT Modified files: /phpdoc/fr/functions errorfunc.xml Log: Xml stuff.Aestethics.
Index: phpdoc/fr/functions/errorfunc.xml diff -u phpdoc/fr/functions/errorfunc.xml:1.9 phpdoc/fr/functions/errorfunc.xml:1.10 --- phpdoc/fr/functions/errorfunc.xml:1.9 Sat Jul 7 18:22:06 2001 +++ phpdoc/fr/functions/errorfunc.xml Fri Nov 2 04:15:46 2001 @@ -1,98 +1,113 @@ - <reference id="ref.errorfunc"> - <title>Gestion des erreurs</title> - <titleabbrev>Gestion des erreurs</titleabbrev> - <partintro> +<?xml encoding="iso-8859-1"?> +<!-- $Revision: 1.10 $ --> +<reference id="ref.errorfunc"> + <title>Gestion des erreurs</title> + <titleabbrev>Gestion des erreurs</titleabbrev> + <partintro> + <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 + d'erreurs à vos besoins. + </para> + <para> + 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. + </para> + <para> + La fonction de niveau d'erreur vous permet de personnaliser le niveau + et le type d'erreur noté : depuis les inoffensives alertes jusqu'au + erreurs personnalisées retournées par les fonctions. + </para> + </partintro> + <refentry id="function.error-log"> + <refnamediv> + <refname>error_log</refname> + <refpurpose>Envoie un message d'erreur quelque part</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>error_log</function></funcdef> + <paramdef>string <parameter>message</parameter></paramdef> + <paramdef>int <parameter>message_type</parameter></paramdef> + <paramdef>string + <parameter><optional>destination</optional></parameter> + </paramdef> + <paramdef>string + <parameter><optional>extra_headers</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> <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 d'erreur - à vos besoins. + <function>error_log</function> envoie un message d'erreur à + l'historique du serveur web, à un port <acronym>TCP</acronym> ou un + fichier. + <parameter>message</parameter> est le message d'erreur qui doit être + enregistré. <parameter>message_type</parameter> indique où le + message doit être envoyé : + <table> + <title>Types de <function>error_log</function></title> + <tgroup cols="2"> + <tbody> + <row> + <entry>0</entry> + <entry> + <parameter>message</parameter> est envoyé à l'historique + PHP, qui est basé sur l'historique système ou un fichier, + en fonction de la configuration de <link + linkend="ini.error-log">error_log</link>. + </entry> + </row> + <row> + <entry>1</entry> + <entry> + <parameter>message</parameter> est envoyé par email à + l'adresse <parameter>destination</parameter>. C'est le seul type qui + utilise le quatrième paramètre + <parameter>extra_headers</parameter>. Ce message + utilise la même fonction interne que <function>mail</function>. + </entry> + </row> + <row> + <entry>2</entry> + <entry> + <parameter>message</parameter> est envoyé par la connexion de + debuggage PHP. Cette option n'est disponible que si l'option + <link + linkend="install.configure.enable-debugger">remote_debugging</link> a + été désactivée. Dans ce cas, le + paramètre <parameter>destination</parameter> spécifie + l'hôte ou l'adresse IP, et optionnellement le numéro de + port, de la socket qui recevra les informations de débuggage. + </entry> + </row> + <row> + <entry>3</entry> + <entry> + <parameter>message</parameter> est ajouté au fichier + <parameter>destination</parameter>. + </entry> + </row> + </tbody> + </tgroup> + </table> </para> + <warning> <para> - Avec les fonctions d'enregistrements, vous pouvez envoyer directement les - rapport à d'autres machines (ou même les envoyer par email à un pager), à l' - historique système, ou encore selectionner les erreurs les plus importantes - et ne pas enregistrer les autres. + Le débuggage à distance via TCP/IP est une + fonctionnalité PHP 3 qui <emphasis>n'est pas</emphasis> disponible en + PHP 4. </para> + </warning> <para> - La fonction de niveau d'erreur vous permet de personnaliser le niveau - et le type d'erreur noté : depuis les inoffensives alertes jusqu'au - erreurs personnalisées retournées par les fonctions. - </para> - </partintro> - <refentry id="function.error-log"> - <refnamediv> - <refname>error_log</refname> - <refpurpose>Envoie un message d'erreur quelque part</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>error_log</function></funcdef> - <paramdef>string <parameter>message</parameter></paramdef> - <paramdef>int <parameter>message_type</parameter></paramdef> - <paramdef>string - <parameter><optional>destination</optional></parameter> - </paramdef> - <paramdef>string - <parameter><optional>extra_headers</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>error_log</function> envoie un message d'erreur à l'historique - du serveur web, à un port <acronym>TCP</acronym> ou un fichier. - <parameter>message</parameter> est le message d'erreur qui doit être - enregistré. <parameter>message_type</parameter> indique où le - message doit être envoyé : - <table> - <title>Types de <function>error_log</function></title> - <tgroup cols="2"> - <tbody> - <row> - <entry>0</entry> - <entry> - <parameter>message</parameter> est envoyé à l'historique PHP, qui est basé - sur l'historique système ou un fichier, en fonction de la configuration - de <link linkend="ini.error-log">error_log</link>. - </entry> - </row> - <row> - <entry>1</entry> - <entry> - <parameter>message</parameter> est envoyé par email à l'adresse - <parameter>destination</parameter>. C'est le seul type qui utilise le - quatrième paramètre <parameter>extra_headers</parameter>. Ce message - utilise la même fonction interne que <function>mail</function>. - </entry> - </row> - <row> - <entry>2</entry> - <entry> - <parameter>message</parameter> est envoyé par la connexion de debuggage - PHP. Cette option n'est disponible que si l'option - <link linkend="install.configure.enable-debugger">remote debugging</link> a été désactivé. - Dans ce cas, le parmètre <parameter>destination</parameter> spécifie - l'hôte ou l'adresse IP, et optionnellement le numéro de port, de la - socket qui recevra les informations de débuggage. - </entry> - </row> - <row> - <entry>3</entry> - <entry> - <parameter>message</parameter> est ajouté au fichier - <parameter>destination</parameter>. - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - <para> - <example role="php"> - <title>Exemples avec <function>error_log</function></title> - <programlisting role="php"> + <example role="php"> + <title>Exemples avec <function>error_log</function></title> + <programlisting role="php"> <?php // Envoi une notification par l'historique du serveur, si la connexion à la base // de données est impossible. @@ -109,129 +124,129 @@ error_log ("Grosse bourde!", 2, "loghost"); error_log ("Grosse bourde!", 3, "/var/tmp/my-errors.log"); ?> - </programlisting> - </example> - </para> - </refsect1> - </refentry> - <refentry id="function.error-reporting"> - <refnamediv> - <refname>error_reporting</refname> - <refpurpose>Fixe le niveau de rapport d'erreurs PHP</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>error_reporting</function></funcdef> - <paramdef>int - <parameter><optional>level</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>error_reporting</function> fixe le niveau de rapport d'erreur PHP - et retourne l'ancienne valeur. Le niveau d'erreur peut être un champs - de bits, ou une constante. L'utilisation des constantes est vivement - recommandé, pour assurer une compatiblité maximale avec - les futures versions. Au fur et à mesure que de nouveaux niveaux - d'erreurs sont créés, l'intervalle de validité des niveaux - évolue, et les anciennes valeurs n'ont plus les mêmes significations. - <example role="php"> - <title>Exemple de modification de niveau d'erreur</title> - <programlisting role="php"> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.error-reporting"> + <refnamediv> + <refname>error_reporting</refname> + <refpurpose>Fixe le niveau de rapport d'erreurs PHP</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>error_reporting</function></funcdef> + <paramdef>int + <parameter><optional>level</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>error_reporting</function> fixe le niveau de rapport d'erreur PHP + et retourne l'ancienne valeur. Le niveau d'erreur peut être un champs + de bits, ou une constante. L'utilisation des constantes est vivement + recommandée, pour assurer une compatibilité maximale avec + les futures versions. Au fur et à mesure que de nouveaux niveaux + d'erreurs sont créés, l'intervalle de validité des niveaux + évolue, et les anciennes valeurs n'ont plus les mêmes significations. + <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 - </programlisting> - </example> - Suivez les liens de chaque valeur interne pour connaître leur signification : - <table> - <title>Constantes avec <function>error_reporting</function></title> - <tgroup cols="2"> - <thead> - <row> - <entry>constante</entry> - <entry>valeur</entry> - </row> - </thead> - <tbody> - <row> - <entry>1</entry> - <entry> - <link linkend="internal.e-error">E_ERROR</link> - </entry> - </row> - <row> - <entry>2</entry> - <entry> - <link linkend="internal.e-warning">E_WARNING</link> - </entry> - </row> - <row> - <entry>4</entry> - <entry> - <link linkend="internal.e-parse">E_PARSE</link> - </entry> - </row> - <row> - <entry>8</entry> - <entry> - <link linkend="internal.e-notice">E_NOTICE</link> - </entry> - </row> - <row> - <entry>16</entry> - <entry> - <link linkend="internal.e-core-error">E_CORE_ERROR</link> - </entry> - </row> - <row> - <entry>32</entry> - <entry> - <link linkend="internal.e-core-warning">E_CORE_WARNING</link> - </entry> - </row> - <row> - <entry>64</entry> - <entry> - <link linkend="internal.e-compile-error">E_COMPILE_ERROR</link> - </entry> - </row> - <row> - <entry>128</entry> - <entry> - <link linkend="internal.e-compile-warning">E_COMPILE_WARNING</link> - </entry> - </row> - <row> - <entry>256</entry> - <entry> - <link linkend="internal.e-user-error">E_USER_ERROR</link> - </entry> - </row> - <row> - <entry>512</entry> - <entry> - <link linkend="internal.e-user-warning">E_USER_WARNING</link> - </entry> - </row> - <row> - <entry>1024</entry> - <entry> - <link linkend="internal.e-user-error">E_USER_NOTICE</link> - </entry> - </row> - </tbody> - </tgroup> - </table> - </para> - <para> - <example role="php"> - <title>Exemples avec <function>error_reporting</function></title> - <programlisting role="php"> + </programlisting> + </example> + Suivez les liens de chaque valeur interne pour connaître leur signification +: + <table> + <title>Constantes avec <function>error_reporting</function></title> + <tgroup cols="2"> + <thead> + <row> + <entry>constante</entry> + <entry>valeur</entry> + </row> + </thead> + <tbody> + <row> + <entry>1</entry> + <entry> + <link linkend="internal.e-error">E_ERROR</link> + </entry> + </row> + <row> + <entry>2</entry> + <entry> + <link linkend="internal.e-warning">E_WARNING</link> + </entry> + </row> + <row> + <entry>4</entry> + <entry> + <link linkend="internal.e-parse">E_PARSE</link> + </entry> + </row> + <row> + <entry>8</entry> + <entry> + <link linkend="internal.e-notice">E_NOTICE</link> + </entry> + </row> + <row> + <entry>16</entry> + <entry> + <link linkend="internal.e-core-error">E_CORE_ERROR</link> + </entry> + </row> + <row> + <entry>32</entry> + <entry> + <link linkend="internal.e-core-warning">E_CORE_WARNING</link> + </entry> + </row> + <row> + <entry>64</entry> + <entry> + <link linkend="internal.e-compile-error">E_COMPILE_ERROR</link> + </entry> + </row> + <row> + <entry>128</entry> + <entry> + <link linkend="internal.e-compile-warning">E_COMPILE_WARNING</link> + </entry> + </row> + <row> + <entry>256</entry> + <entry> + <link linkend="internal.e-user-error">E_USER_ERROR</link> + </entry> + </row> + <row> + <entry>512</entry> + <entry> + <link linkend="internal.e-user-warning">E_USER_WARNING</link> + </entry> + </row> + <row> + <entry>1024</entry> + <entry> + <link linkend="internal.e-user-error">E_USER_NOTICE</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 @@ -272,9 +287,11 @@ fonction PHP par défaut, ou une autre fonction utilisateur). </para> <para> - Voir aussi <function>error_reporting</function>, + Voir aussi + <function>error_reporting</function>, <function>set_error_handler</function>, - <function>trigger_error</function> et <function>user_error</function> + <function>trigger_error</function> et + <function>user_error</function> </para> </refsect1> </refentry> @@ -298,21 +315,21 @@ <parameter>error_handler</parameter> pour gérer les erreurs dans un script. Retourne un pointeur sur l'ancienne fonction de gestion des erreurs (si il y en avait une), ou &false;, en cas d'erreur. - <function>set_error_handler</function> sert à définir votre propre - gestionnaire d'erreur, qui prendra en charge leur traitement durant - l'exécution d'un script. Cela peut être utile lorsque vous devez - repérer des erreurs critiques lors d'un nettoyage de bases, ou bien si - vous souhaitez générer une erreur dans certaines conditions - (avec <function>trigger_error</function>). + <function>set_error_handler</function> sert à définir votre + propre gestionnaire d'erreurs, qui prendra en charge leur traitement durant + l'exécution d'un script. Cela peut être utile lorsque vous + devez repérer des erreurs critiques lors d'un nettoyage de bases, ou + bien si vous souhaitez générer une erreur dans certaines + conditions (avec <function>trigger_error</function>). </para> <para> 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 : + 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 : <example> <title> - Traitement des erreurs avec <function>set_error_handler</function> et + Traitement des erreurs avec <function>set_error_handler</function> et <function>trigger_error</function> </title> <programlisting role="php"> @@ -379,11 +396,11 @@ echo "----\nvector d - fatal error\n"; $d = scale_by_log($a, -2.5); ?> - </programlisting> - </example> - L'éxécution du script devrait donner ceci : - <informalexample> - <programlisting> + </programlisting> + </example> + L'éxécution du script devrait donner ceci : + <informalexample> + <programlisting> vector a Array ( @@ -415,112 +432,121 @@ <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> - </programlisting> - </informalexample> - </para> - <para> - Il faut se rappeler que la fonction standard de traitement des erreurs - de PHP est alors complètement ignorée. <function>error_reporting</function> - 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 <function>error_reporting</function> et - faire réagier la fonction de gestion des erreurs en fonction. - Cette remarque est notamment valable si la commande a été - préfixée par <link linkend="language.operators.errorcontrol">@</link> - (0 sera retourné). - </para> - <para> - Notez aussi qu'il est alors confié à cette fonction de terminer le script - (<function>die</function>) 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. - </para> - <para> - Voir aussi <function>error_reporting</function>, - <function>restore_error_handler</function>, - <function>trigger_error</function>, et <function>user_error</function> - </para> - </refsect1> - </refentry> - <refentry id="function.trigger-error"> - <refnamediv> - <refname>trigger_error</refname> - <refpurpose> - Déclenche une erreur utilisateur - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>void <function>trigger_error</function></funcdef> - <paramdef>string <parameter>error_msg</parameter></paramdef> - <paramdef>int - <parameter><optional>error_type</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>trigger_error</function> est utilisé pour déclencher - une erreur utilisateur. Elle peut aussi être utilisée en - conjonction avec un gestionnaire d'erreur interne, ou un gestionnaire - d'erreurs utilisateur qui a été choisi comme gestionnaire - d'erreur avec <function>set_error_handler</function>. - </para> - <para> - <function>trigger_error</function> est pratique lorsque vous devez générer - une réponse particulière lors de l'exécution. Par exemple - <informalexample> - <programlisting role="php"> + </programlisting> + </informalexample> + </para> + <para> + Il faut se rappeler que la fonction standard de traitement des erreurs + de PHP est alors complètement ignorée. + <function>error_reporting</function> + 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 <function>error_reporting</function> 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 <link +linkend="language.operators.errorcontrol">@</link> + (0 sera retourné). + </para> + <para> + Notez aussi qu'il est alors confié à cette fonction de + terminer le script (<function>die</function>) 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. + </para> + <para> + Voir aussi + <function>error_reporting</function>, + <function>restore_error_handler</function>, + <function>trigger_error</function> et + <function>user_error</function> + </para> + </refsect1> + </refentry> + <refentry id="function.trigger-error"> + <refnamediv> + <refname>trigger_error</refname> + <refpurpose> + Déclenche une erreur utilisateur + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>trigger_error</function></funcdef> + <paramdef>string <parameter>error_msg</parameter></paramdef> + <paramdef>int + <parameter><optional>error_type</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>trigger_error</function> est utilisé pour déclencher + une erreur utilisateur. Elle peut aussi être utilisée en + conjonction avec un gestionnaire d'erreur interne, ou un gestionnaire + d'erreurs utilisateur qui a été choisi comme gestionnaire + d'erreur avec <function>set_error_handler</function>. + </para> + <para> + <function>trigger_error</function> est pratique lorsque vous devez + générer une réponse particulière lors de + l'exécution. Par exemple : + <informalexample> + <programlisting role="php"> <?php if (assert ($divisor == 0)) trigger_error ("Impossible de diviser par zéro", E_USER_ERROR); ?> - </programlisting> - </informalexample> - <note> + </programlisting> + </informalexample> + <note> <para> - Voir <function>set_error_handler</function> pour illustration. + Voir aussi + <function>set_error_handler</function> pour illustration. </para> - </note> - </para> - <para> - Voir aussi <function>error_reporting</function>, - <function>set_error_handler</function>, - <function>restore_error_handler</function>, - <function>user_error</function> - </para> - </refsect1> - </refentry> - <refentry id="function.user-error"> - <refnamediv> - <refname>user_error</refname> - <refpurpose> - Génére un message d'erreur utilisateur - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>void <function>user_error</function></funcdef> - <paramdef>string <parameter>error_msg</parameter></paramdef> - <paramdef>int - <parameter><optional>error_type</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <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>trigger_error</function>. - </para> - </refsect1> - </refentry> - </reference> + </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> + </refsect1> + </refentry> + <refentry id="function.user-error"> + <refnamediv> + <refname>user_error</refname> + <refpurpose> + Génère un message d'erreur utilisateur + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>user_error</function></funcdef> + <paramdef>string <parameter>error_msg</parameter></paramdef> + <paramdef>int + <parameter><optional>error_type</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <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>trigger_error</function>. + </para> + </refsect1> + </refentry> +</reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml