archived-doc-es/reference/errorfunc/ini.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d4d5216e7a965ca194f6b1c9dee84cecab2674e5 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<!-- CREDITS: DavidA -->

<section xml:id="errorfunc.configuration" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.runtime;
 &extension.runtime;
 <para>
  <table>
   <title>&ConfigureOptions; para la gestión de errores</title>
   <tgroup cols="4">
    <thead>
     <row>
      <entry>&Name;</entry>
      <entry>&Default;</entry>
      <entry>&Changeable;</entry>
      <entry>&Changelog;</entry>
     </row>
    </thead>
    <tbody>
    <row>
     <entry><link linkend="ini.error-reporting">error_reporting</link></entry>
     <entry>NULL</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.display-errors">display_errors</link></entry>
     <entry>"1"</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.display-startup-errors">display_startup_errors</link></entry>
     <entry>"1"</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry>
      Anterior a PHP 8.0.0, el valor por omisión era <literal>"0"</literal>.
     </entry>
    </row>
    <row>
     <entry><link linkend="ini.log-errors">log_errors</link></entry>
     <entry>"0"</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.log-errors-max-len">log_errors_max_len</link></entry>
     <entry>"1024"</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry>
      Sin efecto a partir de PHP 8.0.0, eliminado a partir de PHP 8.1.0.
     </entry>
    </row>
    <row>
     <entry><link linkend="ini.ignore-repeated-errors">ignore_repeated_errors</link></entry>
     <entry>"0"</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.ignore-repeated-source">ignore_repeated_source</link></entry>
     <entry>"0"</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.report-memleaks">report_memleaks</link></entry>
     <entry>"1"</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.track-errors">track_errors</link></entry>
     <entry>"0"</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry>Deprecado a partir de PHP 7.2.0, eliminado a partir de PHP 8.0.0.</entry>
    </row>
    <row>
     <entry><link linkend="ini.html-errors">html_errors</link></entry>
     <entry>"1"</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.xmlrpc-errors">xmlrpc_errors</link></entry>
     <entry>"0"</entry>
     <entry><constant>INI_SYSTEM</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.xmlrpc-error-number">xmlrpc_error_number</link></entry>
     <entry>"0"</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.docref-root">docref_root</link></entry>
     <entry>""</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.docref-ext">docref_ext</link></entry>
     <entry>""</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.error-prepend-string">error_prepend_string</link></entry>
     <entry>NULL</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.error-append-string">error_append_string</link></entry>
     <entry>NULL</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.error-log">error_log</link></entry>
     <entry>NULL</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry></entry>
    </row>
     <row>
      <entry><link linkend="ini.error-log-mode">error_log_mode</link></entry>
      <entry>0o644</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry>Disponible a partir de PHP 8.2.0.</entry>
     </row>
    <row>
     <entry><link linkend="ini.syslog.facility">syslog.facility</link></entry>
     <entry>"LOG_USER"</entry>
     <entry><constant>INI_SYSTEM</constant></entry>
     <entry>Disponible a partir de PHP 7.3.0.</entry>
    </row>
    <row>
     <entry><link linkend="ini.syslog.filter">syslog.filter</link></entry>
     <entry>"no-ctrl"</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry>Disponible a partir de PHP 7.3.0.</entry>
    </row>
    <row>
     <entry><link linkend="ini.syslog.ident">syslog.ident</link></entry>
     <entry>"php"</entry>
     <entry><constant>INI_SYSTEM</constant></entry>
     <entry>Disponible a partir de PHP 7.3.0.</entry>
    </row>
    </tbody>
   </tgroup>
  </table>
  &ini.php.constants;
 </para>

 &ini.descriptions.title;

 <para>
  <variablelist>
   <varlistentry xml:id="ini.error-reporting">
    <term>
     <parameter>error_reporting</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      Establece el nivel de error. Este parámetro es un entero, representando un
      campo de bits. Añada los valores siguientes para elegir el nivel
      que desee, tal como se describe en la sección
      <link linkend="errorfunc.constants">Constantes predefinidas</link>,
      y en el archivo &php.ini;. Para modificar esta configuración durante
      la ejecución del script, utilice la función
      <function>error_reporting</function>. Consulte también la directiva
      <link linkend="ini.display-errors">display_errors</link>.
     </para>
     <para>
      El valor por omisión es <constant>E_ALL</constant>.
     </para>
     <para>
      Anterior a PHP 8.0.0, el valor por omisión era :
      <userinput><constant>E_ALL</constant> &amp;
       ~<constant>E_NOTICE</constant> &amp;
       ~<constant>E_STRICT</constant> &amp;
       ~<constant>E_DEPRECATED</constant></userinput>.
      Esto significa que los diagnósticos de nivel <constant>E_NOTICE</constant>,
      <constant>E_STRICT</constant> y <constant>E_DEPRECATED</constant> no eran mostrados.
     </para>
     <note>
      <title>Las constantes PHP fuera de PHP</title>
      <para>
       El uso de las constantes PHP fuera de PHP, como en el archivo
       <filename>httpd.conf</filename>, no tiene significado útil excepto
       en los casos donde se necesitan valores enteros. Y desde que los niveles
       de errores fueron añadidos, el valor máximo (para <constant>E_ALL</constant>)
       debería cambiar. Por lo tanto, en lugar de <constant>E_ALL</constant>, utilice
       un valor más grande para cubrir todos los bits, un valor numérico como
       <literal>2147483647</literal> (incluyendo todos los errores, y no solo
       los errores de tipo <constant>E_ALL</constant>).
      </para>
     </note>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.display-errors">
    <term>
     <parameter>display_errors</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Esta directiva determina si los errores deben ser
      mostrados en pantalla o no.
     </para>
     <para>
      El valor <literal>"stderr"</literal> envía los errores a <literal>stderr</literal>
      en lugar de a <literal>stdout</literal>.
     </para>
     <note>
      <para>
       Es una directiva necesaria en desarrollo, pero que nunca debe ser utilizada
       en un sistema en producción. (ej. sistemas conectados a Internet).
      </para>
     </note>
     <note>
      <para>
       Aunque display_errors puede ser definido durante la ejecución (con
       la función <function>ini_set</function>), no tendrá efecto si el script
       tiene errores fatales, ya que la acción deseada en el momento de la ejecución
       no será ejecutada.
      </para>
     </note>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.display-startup-errors">
    <term>
     <parameter>display_startup_errors</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      Aunque display_errors esté activado, pueden ocurrir errores durante
      la secuencia de inicio de PHP, y estos errores son ocultados.
      Con esta opción, puede mostrarlos, lo cual es recomendado
      para el depurado. Fuera de este caso, se recomienda encarecidamente
      dejar display_startup_errors en off.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.log-errors">
    <term>
     <parameter>log_errors</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      Indica si los mensajes de error generados por los scripts deben
      ser registrados en el registro de errores del servidor o en
      <link linkend="ini.error-log">error_log</link>.
      Esta función es específica del servidor.
     </para>
     <note>
      <para>
       Se recomienda utilizar el historial de errores, en lugar de
       mostrar los errores en los sitios de producción.
      </para>
     </note>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.log-errors-max-len">
    <term>
     <parameter>log_errors_max_len</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      Configura la longitud máxima de los errores que serán registrados en
      el historial, en kilobytes. En las informaciones de
      <link linkend="ini.error-log">error_log</link>, se añade el origen.
      El valor por omisión es de 1024. 0 significa que no hay límite de
      longitud. Esta longitud se aplica para registrar en el historial
      los errores, mostrar los errores y también a <varname>$php_errormsg</varname>
      pero no para las llamadas explícitas a funciones como <function>error_log</function>.
     </para>

     &ini.shorthandbytes;

    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.ignore-repeated-errors">
    <term>
     <parameter>ignore_repeated_errors</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      No registrar mensajes repetitivos. Los errores repetidos
      deben ocurrir en el mismo momento, en la misma línea y desde el mismo archivo de script,
      a menos que <link linkend="ini.ignore-repeated-source">ignore_repeated_source</link>
      esté definido a &true;.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.ignore-repeated-source">
    <term>
     <parameter>ignore_repeated_source</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      Ignora la fuente del mensaje en los mensajes repetidos. Cuando se ha configurado
      esta opción a On, no se registrarán los errores repetidos
      provenientes de archivos y líneas de código diferentes.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.report-memleaks">
    <term>
     <parameter>report_memleaks</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      Si este parámetro está definido a On (por omisión), mostrará un informe de
      fuga de memoria detectada por el gestor de memoria Zend. Este informe
      será enviado a stderr en las plataformas Posix. En Windows, será
      enviado al depurador utilizando OutputDebugString() y podrá ser leído
      con herramientas como <link xlink:href="&url.dbgview;">DbgView</link>.
      Este parámetro solo tiene efecto durante una compilación de depuración, y si
      error_reporting incluye <constant>E_WARNING</constant> en su lista autorizada.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.track-errors">
    <term>
     <parameter>track_errors</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      Si esta opción está activada, el último mensaje de error será colocado en la
      variable <varname>$php_errormsg</varname>.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.html-errors">
    <term>
     <parameter>html_errors</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      Si está activado, los mensajes de error incluirán etiquetas HTML. El formato
      de los errores HTML producirá mensajes clicables que redirigirán al usuario
      hacia una página describiendo el error o la función que causó el error.
      Estas referencias son afectadas por
      <link linkend="ini.docref-root">docref_root</link> y
      <link linkend="ini.docref-ext">docref_ext</link>.
     </para>
     <para>
      Si está desactivado, el mensaje de error será mostrado en texto plano.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.xmlrpc-errors">
    <term>
     <parameter>xmlrpc_errors</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      Si está activado, desactiva el informe normal de error y formatea los errores
      como mensajes de error XML-RPC.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.xmlrpc-error-number">
    <term>
     <parameter>xmlrpc_error_number</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      Utilizado como valor del elemento XML-RPC faultcode.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.docref-root">
    <term>
     <parameter>docref_root</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      El nuevo formato de error contiene una referencia a una página describiendo
      el error, o la función que causó el error. Para el manual, puede
      descargar este último en su idioma, y configurar esta opción para que apunte a él. Si su copia del manual es accesible a
      <literal>"/manual/"</literal>, puede simplemente utilizar
      <userinput>docref_root=/manual/</userinput>. Además, debe configurar
      <parameter>docref_ext</parameter> para que corresponda a las extensiones de su manual.
      <userinput>docref_ext=.html</userinput>. Es posible utilizar referencias externas. Por ejemplo, puede utilizar
      <userinput>docref_root=http://manual/en/</userinput> o
      <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 mayoría de las veces, se utiliza la opción docref_root con una barra al final (<literal>"/"</literal>).
      Pero no es obligatorio, como muestra el segundo ejemplo anterior.
     </para>
     <note>
      <para>
       Esta directiva está destinada a ayudar en el desarrollo haciendo
       fácil la consulta de la descripción de una función. Nunca debe ser utilizada en un
       sistema de producción (ej. sistema conectado a Internet).
      </para>
     </note>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.docref-ext">
    <term>
     <parameter>docref_ext</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Consulte también <link linkend="ini.docref-root">docref_root</link>.
     </para>
     <note>
      <para>
       El valor de docref_ext debe comenzar con un punto <literal>"."</literal>.
      </para>
     </note>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.error-prepend-string">
    <term>
     <parameter>error_prepend_string</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      La cadena a colocar antes de los mensajes de error.
      Solo utilizado cuando el mensaje de error es mostrado en pantalla.
      El uso principal es poder añadir etiquetado HTML adicional
      antes del mensaje de error.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.error-append-string">
    <term>
     <parameter>error_append_string</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      La cadena a colocar después de los mensajes de error.
      Solo utilizado cuando el mensaje de error es mostrado en pantalla.
      El uso principal es poder añadir etiquetado HTML adicional
      después del mensaje de error.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.error-log">
    <term>
     <parameter>error_log</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Nombre del archivo donde serán registrados los errores. El archivo
      debe ser accesible en escritura por el usuario ejecutando
      el servidor web. Si el
      valor especial <literal>syslog</literal> es utilizado, los errores
      serán enviados al sistema de registro del servidor. En
      Unix, esto corresponde a syslog(3) y en Windows al
      registro de eventos. Consulte también: <function>syslog</function>.
      Si esta directiva no está fijada, los errores son enviados al registro de errores SAPI. Por ejemplo, si es un registro de errores en
      Apache o <literal>stderr</literal> en CLI.
      Consulte también la función <function>error_log</function>.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.error-log-mode">
    <term>
     <parameter>error_log_mode</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      Modo de archivo para el archivo definido para
      <link linkend="ini.error-log">error_log</link>.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.syslog.facility">
    <term>
     <parameter>syslog.facility</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Especifica el tipo de programa que registra el mensaje. Solo
      efectivo si <link linkend="ini.error-log">error_log</link> está definido
      como "syslog".
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.syslog.filter">
    <term>
     <parameter>syslog.filter</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Especifica el tipo de filtro para filtrar los mensajes registrados. Los
      caracteres permitidos son pasados sin modificación; todos los demás son
      escritos en su representación hexadecimal prefijada con <literal>\x</literal>.
      <itemizedlist>
       <listitem>
        <simpara><literal>all</literal> – la cadena registrada será separada en
         caracteres de retorno de línea, y todos los caracteres son transmitidos
         sin alteraciones
        </simpara>
       </listitem>
       <listitem>
        <simpara><literal>ascii</literal> – la cadena registrada será separada en
         caracteres de retorno de línea, y todo carácter 7-bit ASCII no imprimible será escapado
        </simpara>
       </listitem>
       <listitem>
        <simpara><literal>no-ctrl</literal> – la cadena registrada será separada en
         caracteres de retorno de línea, y los caracteres no imprimibles serán escapados
        </simpara>
       </listitem>
       <listitem>
        <simpara><literal>raw</literal> – todos los caracteres son pasados al
         sistema de registro sin alteraciones, sin separaciones en los retornos
         de línea (idéntico a PHP anterior a 7.3)
        </simpara>
       </listitem>
      </itemizedlist>
      Este parámetro afectará el registro a través de
      <link linkend="ini.error-log">error_log</link> definido como "syslog" y
      las llamadas a <function>syslog</function>.
     </para>
     <note>
      <para>
       El tipo de filtro <literal>raw</literal> está disponible a partir de PHP 7.3.8 y PHP 7.4.0.
      </para>
     </note>
     <simpara>
      Esta directiva no es soportada en Windows.
     </simpara>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.syslog.ident">
    <term>
     <parameter>syslog.ident</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Especifica la cadena de identidad que es añadida a cada mensaje.
      Solo efectivo si <link linkend="ini.error-log">error_log</link> está
      definido como "syslog".
     </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:"~/.phpdoc/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
-->