doc-fr/reference/errorfunc/ini.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.24 $ -->
<!-- EN-Revision: 1.27 Maintainer: yannick Status: ready -->
<section id="errorfunc.configuration">
 &reftitle.runtime;
 &extension.runtime;
 <para>
  <table>
   &ini.table.title;
   <tgroup cols="4">
    <thead>
     &ini.table.top;
    </thead>
    <tbody>
     <row>
      <entry>error_reporting</entry>
      <entry>NULL</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry>display_errors</entry>
      <entry>"1"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry>display_startup_errors</entry>
      <entry>"0"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible depuis &php; 4.0.3.</entry>
     </row>
     <row>
      <entry>log_errors</entry>
      <entry>"0"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry>log_errors_max_len</entry>
      <entry>"1024"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible depuis &php; 4.3.0.</entry>
     </row>
     <row>
      <entry>ignore_repeated_errors</entry>
      <entry>"0"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible depuis &php; 4.3.0.</entry>
     </row>
     <row>
      <entry>ignore_repeated_source</entry>
      <entry>"0"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible depuis &php; 4.3.0.</entry>
     </row>
     <row>
      <entry>report_memleaks</entry>
      <entry>"1"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible depuis &php; 4.3.0.</entry>
     </row>
     <row>
      <entry>track_errors</entry>
      <entry>"0"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry>html_errors</entry>
      <entry>"1"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>PHP_INI_SYSTEM en &php; &lt;=4.2.3. Disponible depuis &php; 4.0.2.</entry>
     </row>
     <row>
      <entry>docref_root</entry>
      <entry>""</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible depuis &php; 4.3.0.</entry>
     </row>
     <row>
      <entry>docref_ext</entry>
      <entry>""</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible depuis &php; 4.3.2.</entry>
     </row>
     <row>
      <entry>error_prepend_string</entry>
      <entry>NULL</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry>error_append_string</entry>
      <entry>NULL</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry>error_log</entry>
      <entry>NULL</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry>warn_plus_overloading</entry>
      <entry>NULL</entry>
      <entry>PHP_INI??</entry>
      <entry></entry>
     </row>
    </tbody>
   </tgroup>
  </table>
  &ini.php.constants;
 </para>

 &ini.descriptions.title;

 <para>
  <variablelist>
   <varlistentry id="ini.error-reporting">
    <term>
     <parameter>error_reporting</parameter>
     &integer;
    </term>
    <listitem>
     <para>
      Fixe le niveau d'erreur. Ce paramètre est un entier, représentant un
      champ de bits. Ajoutez les valeurs suivantes pour choisir le niveau
      que vous désirez, telles que décrites dans la section
      <link linkend="errorfunc.constants">Constantes pré-définies</link>,
      et dans le fichier &php.ini;. Pour modifier cette configuration durant
      l'exécution du script, utilisez la fonction
      <function>error_reporting</function>. Voyez aussi la directive
      <link linkend="ini.display-errors">display_errors</link>.
     </para>
     <para>
      En &php; 4 et &php; 5, la configuration par défaut est
      <constant>E_ALL</constant> &amp; ~<constant>E_NOTICE</constant>. Elle montre toutes les erreurs, sauf
      les <constant>E_NOTICE</constant>. Il est recommandé de les afficher
      durant le développement.
     </para>
     <note>
      <para>Activer le rapport d'erreur de niveau <constant>E_NOTICE</constant>
       durant le développement a des avantages. En terme de débogage, les message
       d'alertes vous signalent des bogues potentiels dans votre code. Par exemple,
       l'utilisation de valeurs non initialisées est signalée. Il est aussi plus
       pratique pour trouver des coquilles, et, ainsi, gagner du temps. Les messages
       NOTICE vous signaleront aussi les mauvaises pratiques de codage. Par
       exemple <literal>$arr[item]</literal> doit toujours être écrit
       <literal>$arr['item']</literal> car &php; va considérer "item" comme
       une constante, au premier abord. Si cette constante n'est pas définie,
       alors il va l'utiliser comme une chaîne.
      </para>
     </note>
     <note>
      <para>
       En &php; 5, un nouveau niveau d'erreur nommé <constant>E_STRICT</constant>
       est disponible. Comme <constant>E_STRICT</constant> n'est pas inclus sans
       <constant>E_ALL</constant>, vous devez explicitement activer ce niveau d'erreur.
       Activer <constant>E_STRICT</constant> pendant le développement peut être
       bénéfique. Les messages STRICT vous aideront à utiliser la dernière et meilleure
       suggestion de méthode de codage, par exemple, vous alertera de l'utilisation
       de fonctions non recommandées.
      </para>
     </note>
     <para>
      En &php; 3, la configuration par défaut est
      <literal>(E_ERROR | E_WARNING | E_PARSE)</literal>,
      ce qui correspond à la même configuration qu'en &php; 4. Notez toutefois que
      les constantes ne sont pas supportées dans le <filename>php3.ini</filename>
      de &php; 3, et que le niveau d'erreur doit être spécifié numériquement,
      c'est à dire <literal>7</literal>.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry id="ini.display-errors">
    <term>
     <parameter>display_errors</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      Cette directive détermine si les erreurs doivent être
      affichées à l'écran ou non.
     </para>
     <note>
      <para>
       C'est une directive nécessaire en développement mais qui ne doit jamais être utilisée
       sur un système en production. (e.g. systèmes connectés à Internet).
      </para>
     </note>
     <note>
      <para>
       Bien que display_errors peut être défini en cours d'exécution (avec 
       la fonction <function>ini_set</function>), il n'aura aucun effet si le script
       a des erreurs fatales, car l'action désirée au moment de l'exécution
       ne sera pas exécutée.
      </para>
     </note>
    </listitem>
   </varlistentry>

   <varlistentry id="ini.display-startup-errors">
    <term>
     <parameter>display_startup_errors</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      Même si display_errors est activé, des erreurs peuvent survenir lors
      de la séquence de démarrage de &php;, et ces erreurs sont cachées.
      Avec cette option, vous pouvez les afficher, ce qui est recommandé
      pour le débogage. En dehors de ce cas, il est fortement recommandé
      de laisser display_startup_errors à off.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry id="ini.log-errors">
    <term>
     <parameter>log_errors</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      Indique où les messages d'erreur générés doivent
      être écrits : dans l'historique du serveur ou dans
      <link linkend="ini.error-log">error_log</link>. Cette fonction est spécifique aux serveurs.
     </para>
     <note>
      <para>
       Il est recommandé d'utiliser l'historique d'erreur, plutôt que
       d'afficher les erreurs sur les sites de production.
      </para>
     </note>
    </listitem>
   </varlistentry>

   <varlistentry id="ini.log-errors-max-len">
    <term>
     <parameter>log_errors_max_len</parameter>
     &integer;
    </term>
    <listitem>
     <para>
      Configure la taille maximale des erreurs qui seront enregistrées dans
      l'historique, en kilo octets. Dans les informations de
      <link linkend="ini.error-log">error_log</link>, l'origine est ajoutée.
      La valeur par défaut est de 1024. 0 signifie qu'il n'y a pas de limite de
      taille.
      Cette longueur est appliqué pour enregistrer dans l'historique les erreurs,
      afficher les erreurs et également à
      <link linkend="reserved.variables.phperrormsg">$php_errormsg</link>.
     </para>

     &ini.shorthandbytes;

    </listitem>
   </varlistentry>

   <varlistentry id="ini.ignore-repeated-errors">
    <term>
     <parameter>ignore_repeated_errors</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      Ne pas enregistrer des messages répétitifs. Les erreurs répétées
      doivent survenir au même moment, à la même ligne et depuis le même fichier de script,
      jusqu'à ce que <link linkend="ini.ignore-repeated-source">ignore_repeated_source</link>
      soit mis à &true;.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry id="ini.ignore-repeated-source">
    <term>
     <parameter>ignore_repeated_source</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      Ignore la source du message lors des messages répétés. Lorsque vous avez configuré
      cette option à On, vous n'enregistrerez pas les erreurs répétées
      provenant de fichiers et lignes de code différents.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry id="ini.report-memleaks">
    <term>
     <parameter>report_memleaks</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      Si ce paramètre est mis à Off, alors les fuites de mémoires ne seront pas
      affichées (sur la sortie standard, stdout ou dans les logs). Cette option
      n'a d'effet que si &php; a été compilé avec l'option de débogage, et si
      <link linkend="ini.error-reporting">error_reporting</link> inclut
      <constant>E_WARNING</constant> dans sa liste.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry id="ini.track-errors">
    <term>
     <parameter>track_errors</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      Si cette option est activée, le dernier message d'erreur sera placé dans la
      variable globale <link linkend="reserved.variables.phperrormsg"><symbol>$php_errormsg</symbol></link>.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry id="ini.html-errors">
    <term>
     <parameter>html_errors</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      Désactive les balises HTML dans les messages d'erreurs. Le nouveau
      format d'erreurs HTML fournit des messages cliquables, qui redirige
      l'utilisateur vers la documentation de l'erreur ou de la fonction. Ces
      références sont affectées par
      <link linkend="ini.docref-root">docref_root</link> et
      <link linkend="ini.docref-ext">docref_ext</link>.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry id="ini.docref-root">
    <term>
     <parameter>docref_root</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Le nouveau format d'erreur contient une référence à une page décrivant
      l'erreur, ou la fonction ayant causé l'erreur. Pour le manuel, vous pouvez
      télécharger ce dernier dans votre langue, et configurer cette option pour qu'elle
      pointe sur lui. Si votre copie du manuel est accessible à
      '/manual/', vous pouvez simplement utiliser
      <userinput>docref_root=/manual/</userinput>. De plus, vous devez configurer
      docref_ext pour qu'elle corresponde aux extensions de votre manuel.
      <userinput>docref_ext=.html</userinput>. Il est possible d'utiliser des
      références externes. Par exemple, vous pouvez utiliser
      <userinput>docref_root=http://manual/en/</userinput> ou
      <userinput>docref_root="http://landonize.it/?how=url&amp;theme=classic&amp;filter=Landon&amp;url=http%3A%2F%2Fwww.php.net%2F"</userinput>
     </para>
     <para>
      La plupart du temps, vous utilisez l'option docref_root avec un slash a la fin ('/').
      Mais ce n'est pas obligatoire, comme le montre le second exemple ci-dessus.
     </para>
     <note>
      <para>
       Cette directive est destiné à vous aider dans votre développement en rendant
       facile la consultation de la description d'une fonction. Ne jamais l'utiliser sur un
       système de production (e.g. système connecté à Internet).
      </para>
     </note>
    </listitem>
   </varlistentry>

   <varlistentry id="ini.docref-ext">
    <term>
     <parameter>docref_ext</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Voir aussi <link linkend="ini.docref-root">docref_root</link>.
     </para>
     <note>
      <para>
       La valeur de docref_ext doit commencer par un point '.'.
      </para>
     </note>
    </listitem>
   </varlistentry>

   <varlistentry id="ini.error-prepend-string">
    <term>
     <parameter>error_prepend_string</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      La chaîne à placer avant les messages d'erreur.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry id="ini.error-append-string">
    <term>
     <parameter>error_append_string</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      La chaîne à placer après les messages d'erreur.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry id="ini.error-log">
    <term>
     <parameter>error_log</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Nom du fichier où seront enregistrées les erreurs. Le fichier
      doit être accessible en écriture par l'utilisateur exécutant 
      le serveur web. Si la
      valeur spéciale <literal>syslog</literal> est utilisée, les erreurs
      seront envoyées au système d'historique du serveur. Sous
      Unix, cela correspond à syslog(3) et sous Windows NT, à
      l'historique d'événement. L'historique n'est pas supporté
      sous Windows 95. Voir aussi : <function>syslog</function>.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry id="ini.warn-plus-overloading">
    <term>
     <parameter>warn_plus_overloading</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      Si cette option est activée, &php; va afficher une alerte lorsque
      l'opérateur d'addition (<literal>+</literal>) est utilisé avec des
      chaînes de caractères. Cela peut aider à trouver les erreurs où le
      plus est utilisé comme opérateur de concaténation au lieu de
      point (<literal>.</literal>).
     </para>
    </listitem>
   </varlistentry>

  </variablelist>
 </para>
</section>

<!-- 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
-->