doc-fr/reference/errorfunc/ini.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<section id="errorfunc.configuration">
 &reftitle.runtime;
 &extension.runtime;
 <para>
 <table>
  &ini.table.title;
  <tgroup cols="3">
   <thead>
    &ini.table.top;
   </thead>
    <tbody>
    <row>
     <entry>error_reporting</entry>
     <entry>E_ALL &amp; ~E_NOTICE</entry>
     <entry>PHP_INI_ALL</entry>
    </row>
    <row>
     <entry>display_errors</entry>
     <entry>"1"</entry>
     <entry>PHP_INI_ALL</entry>
    </row>
    <row>
     <entry>display_startup_errors</entry>
     <entry>"0"</entry>
     <entry>PHP_INI_ALL</entry>
    </row>
    <row>
     <entry>log_errors</entry>
     <entry>"0"</entry>
     <entry>PHP_INI_ALL</entry>
    </row>
    <row>
     <entry>log_errors_max_len</entry>
     <entry>"1024"</entry>
     <entry>PHP_INI_ALL</entry>
    </row>
    <row>
     <entry>ignore_repeated_errors</entry>
     <entry>"0"</entry>
     <entry>PHP_INI_ALL</entry>
    </row>
    <row>
     <entry>ignore_repeated_source</entry>
     <entry>"0"</entry>
     <entry>PHP_INI_ALL</entry>
    </row>
    <row>
     <entry>report_memleaks</entry>
     <entry>"1"</entry>
     <entry>PHP_INI_SYSTEM</entry>
    </row>
    <row>
     <entry>track_errors</entry>
     <entry>"0"</entry>
     <entry>PHP_INI_ALL</entry>
    </row>
    <row>
     <entry>html_errors</entry>
     <entry>"1"</entry>
     <entry>PHP_INI_ALL</entry>
    </row>
    <row>
     <entry>docref_root</entry>
     <entry>"http://www.php.net/"</entry>
     <entry>PHP_INI_ALL</entry>
    </row>
    <row>
     <entry>docref_ext</entry>
     <entry>".html"</entry>
     <entry>PHP_INI_ALL</entry>
    </row>
    <row>
     <entry>error_prepend_string</entry>
     <entry>NULL</entry>
     <entry>PHP_INI_ALL</entry>
    </row>
    <row>
     <entry>error_append_string</entry>
     <entry>NULL</entry>
     <entry>PHP_INI_ALL</entry>
    </row>
    <row>
     <entry>error_log</entry>
     <entry>NULL</entry>
     <entry>PHP_INI_ALL</entry>
    </row>
    <row>
     <entry>warn_plus_overloading</entry>
     <entry>NULL</entry>
     <entry>PHP_INI??</entry>
    </row>
    </tbody>
   </tgroup>
  </table>
  &ini.table.bottom;
 </para>

 &ini.descriptions.title;

 <para>
  <variablelist>
   <varlistentry id="ini.error-reporting">
    <term>
     <parameter>error_reporting</parameter>
     <type>integer</type>
    </term>
    <listitem>
     <para>
      Fixe le niveau d'erreur. Ce param&egrave;tre est un entier, repr&eacute;sentant un
      champs de bits. Ajoutez les valeurs suivantes pour choisir le niveau
      que vous d&eacute;sirez, telles que d&eacute;crite dans la section 
      <link linkend="errorfunc.constants">Constantes pr&eacute;d&eacute;finies</link>,
      et dans le fichier &php.ini;. Pour modifier cette configuration durant
      l'ex&eacute;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, la configuration par d&eacute;faut montre toutes les erreurs, sauf
      les <constant>E_NOTICE</constant>. Il est recommand&eacute;e de les afficher
      durant le d&eacute;veloppement.
     </para>
     <note>
      <para>Activer le rapport d'erreur de niveau <constant>E_NOTICE</constant> 
      durant le d&eacute;veloppement a des avantages. En terme de d&eacute;bogage, les message
      d'alertes vous signalent des bugs potentiels dans votre code. Par exemple,
      l'utilisation de valeurs non initialis&eacute;es est signal&eacute;. Il est aussi plus
      pratique pour trouver des coquilles, et ainsi, gagner du temps. Les messages
      NOTICE vous signaleront aussi les mauvaises pratiques de codages. Par 
      exemple <literal>$arr[item]</literal> doit toujours &ecirc;tre &eacute;crit 
      <literal>$arr['item']</literal> car PHP va consid&eacute;der "item" comme
      une constante, au premier abord. Si cette constante n'est pas d&eacute;finie,
      alors il va l'utilise comme une cha&icirc;ne.
      </para>
     </note>
     <para>
      En PHP 3, la configuration par d&eacute;faut est 
      <literal>(E_ERROR | E_WARNING | E_PARSE)</literal>,
      ce qui correspond &agrave; la m&ecirc;me configuration qu'en PHP 4. Notez toutefois que
      les constantes ne sont pas support&eacute;es dans le <filename>php3.ini</filename>
      de PHP 3, et que le niveau d'erreur doit &ecirc;tre sp&eacute;cifi&eacute; num&eacute;riquement,
      c'est &agrave; 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&eacute;termine si les erreurs doivent &ecirc;tre
         affich&eacute;es &agrave; l'&eacute;cran au format HTML ou non.
     </para>
    </listitem>
   </varlistentry>

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

   <varlistentry id="ini.log-errors">
    <term>
     <parameter>log_errors</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      Indique o&ugrave; les messages d'erreur g&eacute;n&eacute;r&eacute;s doivent
      &ecirc;tre &eacute;crits, dans l'historique du serveur ou dans 
      <link linkend="ini.error-log">error_log</link>. Cette fonction est sp&eacute;cifique aux serveurs.
     </para>
     <note>
      <para>
       Il est recommand&eacute; d'utiliser l'historique d'erreur, plut&ocirc;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>
     <type>integer</type>
    </term>
    <listitem>
     <para>
      Configure la taille maximale des erreurs qui seront enregistr&eacute;es dans
      l'historique, en kilo octets. Dans les informations de 
      <link linkend="ini.error-log">error_log</link>, l'origine est ajout&eacute;e.
      La valeur par d&eacute;faut est de 1024. 0 signifie qu'il n'y a pas de limite de
      taille.
     </para>
    </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&eacute;p&eacute;titifs. Les erreurs r&eacute;p&eacute;t&eacute;es
      doivent survenir au m&ecirc;me moment, &agrave; la m&ecirc;me ligne et depuis le m&ecirc;me fichier de script,
      jusqu'&agrave; ce que <link linkend="ini.ignore-repeated-source">ignore_repeated_source</link>
      soit mis &agrave; &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&eacute;p&eacute;t&eacute;s. Lorsuqe vous avez configur&eacute;
      cette option &agrave; On, vous n'enregistrerez par les erreurs les erreurs r&eacute;p&eacute;t&eacute;es
      provenant de fichier et lignes de code diff&eacute;rents.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry id="ini.report-memleaks">
    <term>
     <parameter>report_memleaks</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      Si ce param&egrave;tre est mis &agrave; Off, alors les fuites de m&eacute;moires ne seront pas
      affich&eacute;es (sur la sortie standard, stdout ou dans les logs). Cette option
      n'a d'effet que si PHP a &eacute;t&eacute; compil&eacute; avec l'option de d&eacute;bogage, et si 
      <link linkend="ini.error-reporting">error_reporting</link> inclut
      E_WARNING 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&eacute;e, le dernier message d'erreur sera plac&eacute; 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&eacute;sactive les balises HTML dans les messages d'erreurs. Le nouveau
      format d'erreurs HTML fournit des messages cliquable, qui redirige
      l'utilisateur vers la documentation de l'erreur ou de la fonction. Ces 
      r&eacute;f&eacute;rences sont affect&eacute;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&eacute;f&eacute;rence &agrave; une page d&eacute;crivant
      l'erreur, ou la fonction ayant caus&eacute; l'erreur. Pour le manuel, vous pouvez
      t&eacute;l&eacute;charger le manuel dans votre langue, et configurer cette option pour qu'elle
      pointe sur votre manuel. Si votre copie du manuel est accessible &agrave; 
      '/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&eacute;f&eacute;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>
    </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 avec 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&icirc;ne &agrave; 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&icirc;ne &agrave; placer apr&egrave;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&ugrave; seront enregistr&eacute;es les erreurs. Si la
      valeur sp&eacute;ciale <literal>syslog</literal> est utilis&eacute;e, les erreurs
      seront envoy&eacute;es au syst&egrave;me d'historique du serveur. Sous
      Unix, cela correspond &agrave; syslog(3) et sous Windows NT, &agrave;
      l'historique d'&eacute;v&eacute;nement. L'historique n'est pas support&eacute; 
      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&eacute;e, PHP va afficher une alerte lorsque
      l'op&eacute;rateur d'addition (<literal>+</literal>) est utilis&eacute; avec des
      cha&icirc;nes de caract&egrave;res. Cela peut aider &agrave; trouver les erreurs o&ugrave; le
      plus est utilis&eacute; comme op&eacute;rateur de concat&eacute;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
-->