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

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: aceea02784025ae4c461c889d2c891920bf9a5ed Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<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>Opciones de configuración de errores y registro</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>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.display-errors">display_errors</link></entry>
      <entry>"1"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.display-startup-errors">display_startup_errors</link></entry>
      <entry>"0"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.log-errors">log_errors</link></entry>
      <entry>"0"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.log-errors-max-len">log_errors_max_len</link></entry>
      <entry>"1024"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible a partir de PHP 4.3.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.ignore-repeated-errors">ignore_repeated_errors</link></entry>
      <entry>"0"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible a partir de PHP 4.3.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.ignore-repeated-source">ignore_repeated_source</link></entry>
      <entry>"0"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible a partir de PHP 4.3.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.report-memleaks">report_memleaks</link></entry>
      <entry>"1"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible a partir de PHP 4.3.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.track-errors">track_errors</link></entry>
      <entry>"0"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.html-errors">html_errors</link></entry>
      <entry>"1"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>PHP_INI_SYSTEM en PHP &lt;= 4.2.3.</entry>
     </row>
     <row>
      <entry><link linkend="ini.xmlrpc-errors">xmlrpc_errors</link></entry>
      <entry>"0"</entry>
      <entry>PHP_INI_SYSTEM</entry>
      <entry>Disponible a partir de PHP 4.1.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.xmlrpc-error-number">xmlrpc_error_number</link></entry>
      <entry>"0"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible a partir de PHP 4.1.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.docref-root">docref_root</link></entry>
      <entry>""</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible a partir de PHP 4.3.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.docref-ext">docref_ext</link></entry>
      <entry>""</entry>
      <entry>PHP_INI_ALL</entry>
      <entry>Disponible a partir de PHP 4.3.2.</entry>
     </row>
     <row>
      <entry><link linkend="ini.error-prepend-string">error_prepend_string</link></entry>
      <entry>NULL</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.error-append-string">error_append_string</link></entry>
      <entry>NULL</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.error-log">error_log</link></entry>
      <entry>NULL</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.syslog.facility">syslog.facility</link></entry>
      <entry>"LOG_USER"</entry>
      <entry>PHP_INI_SYSTEM</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>PHP_INI_ALL</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>PHP_INI_SYSTEM</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>integer</type>
    </term>
    <listitem>
     <para>
      Establece el nivel de notificación de errores. El parámetro es o bien un valor de tipo
      integer que representa un campo de bits, o bien constantes con nombre. Los niveles de error_reporting
      y las constantes están descritos en
      <link linkend="errorfunc.constants">Constantes predefinidas</link>,
      y en &php.ini;. Para establecerlo en tiempo de ejecución, se ha de usar la
      función <function>error_reporting</function>. Vése también la
      directiva <link linkend="ini.display-errors">display_errors</link>.
     </para>
     <para>
      En PHP 5.3 o posterior, el valor predeterminado
      es <constant>E_ALL</constant> &amp;
      ~<constant>E_NOTICE</constant> &amp;
      ~<constant>E_STRICT</constant> &amp;
      ~<constant>E_DEPRECATED</constant>. Este ajuste no muestra
      los niveles de error <constant>E_NOTICE</constant>, <constant>E_STRICT</constant>
      y <constant>E_DEPRECATED</constant>. Quizás quiera
      mostrarlos durante el desarrollo.
      Antes de PHP 5.3.0, el valor predeterminado
      es <constant>E_ALL</constant> &amp;
      ~<constant>E_NOTICE</constant> &amp;
      ~<constant>E_STRICT</constant>. 
      en PHP, el valor predeterminado es <constant>E_ALL</constant>
      &amp; ~<constant>E_NOTICE</constant>.
     </para>
     <note>
      <para>La habilitación de  <constant>E_NOTICE</constant> durante el desarrollo tiene
       algunos beneficios. Para las depuración: los mensajes NOTICE avisarán
       de posibles errores en el código. Por ejemplo, se advierte del uso de valores no
       asignados. Es extremadamente útil para encontrar errartas y
       ahorrar tiempo en la depuración. Los mensajes NOTICE avisarán de un estilo malo.
       Por ejemplo, <literal>$arr[item]</literal> es mejor que sea escrito como
       <literal>$arr['item']</literal> ya que PHP intenta tratar
       <literal>"item"</literal> como una constante. Si no es una constante, PHP asume
       que es un índice de string del array.
      </para>
     </note>
     <note>
      <para>
       En PHP 5 está disponible el nuevo nivel de error <constant>E_STRICT</constant>.
       Antes de PHP 5.4.0, <constant>E_STRICT</constant> no estaba incluido dentro de
       <constant>E_ALL</constant>, por lo que se teniía de habilitar explícitamente este tipo de
       nivel de error en PHP &lt; 5.4.0. La habilitación de <constant>E_STRICT</constant> durante el desarrollo
       tiene algunos beneficios. Los mensajes STRICT proporcionan sugerencias que pueden ayudar
       a asegurarse de la mejor interoperabilidad y la compatibilidad hacia delante del código.
       Estos mensajes pueden incluir cosas como llamar a métodos no estáticos de forma
       estática, definir propiedades en una definición de clase compatible mientras
       se definió en un trait usado, y antes de PHP 5.3, algunas características obsoletas
       emitirían errores <constant>E_STRICT</constant> como asignar
       objetos por referencias durante la instanciación.
      </para>
     </note>
     <note>
      <title>Constantes de PHP fuera de PHP</title>
      <para>
       El uso de constantes de PHP fuera de PHP, como en <filename>httpd.conf</filename>,
       no tiene un propósito útil, por lo que, en tales casos, se requerirán los valores
       de tipo <type>integer</type>. Y ya que se añadirán más niveles de error en el futuro, el valor
       máximo (para <constant>E_ALL</constant>) cambiará igualmente. Por lo que, en lugar de
       <constant>E_ALL</constant> se ha de considerar el uso de un valor grande para cubrir todos los campos
       de bits desde la actualidad hasta bien entrado en el futuro, un valor numérico como
       <literal>2147483647</literal> (incluye todos los errores, no sólo
       <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>
      Determina si los errores deberían ser impresos en pantalla
      como parte de la salida o si deberían ocultarse al usuario.
     </para>
     <para>
      El valor <literal>"stderr"</literal> envía los errores a <literal>stderr</literal>
      en vez de a <literal>stdout</literal>. Este valor está disponible a partir de PHP
      5.2.4. En versiones anteriores esta directiva era de tipo <type>boolean</type>.
     </para>
     <note>
      <para>
       Ésta es una característica para ayudar al desarrollo y nunca debería usarse
       en sistemas de producción (p.ej. en sistemas conectados a internet).
      </para>
     </note>
     <note>
      <para>
       Aunque display_errors puede ser establecido en tiempo de ejecución (con <function>ini_set</function>),
       no tendrá ningún efecto si el script tiene errores fatales.
       Esto es debido a que la acción deseada en tiempo de ejecución no se ejecuta.
      </para>
     </note>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.display-startup-errors">
    <term>
     <parameter>display_startup_errors</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      Incluso cuando display_errors está activado, los errores que ocurren durante la secuencia de 
      arranque de PHP no se muestran. Se recomienda encarecidamente mantener desactivado
      display_startup_errors, excepto para la depuración.
     </para>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.log-errors">
    <term>
     <parameter>log_errors</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      Indica si los mensajes de error del script deberían de registrarse en el
      registro del servidor o en <link linkend="ini.error-log">error_log</link>.
      Esta opción es, por lo tanto, específica para servidores.
     </para>
     <note>
      <para>
       Se aconseja encarecidamente usar el registro de errores en lugar de
       mostrar los errores en sitios web de producción.
      </para>
     </note>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.log-errors-max-len">
    <term>
     <parameter>log_errors_max_len</parameter>
     <type>integer</type>
    </term>
    <listitem>
     <para>
      Establece la longitud máxima de log_errors en bytes. En
      <link linkend="ini.error-log">error_log</link> se añade información acerca
      del origen. El valor predeterminado es 1024, y 0 permite no aplicar
      ninguna longitud máxima en absoluto.
      Esta longitud se aplica a los errores registrados, a los errores mostrados y también a
      <varname>$php_errormsg</varname>, pero no a las funciones llamadas explícitamente
      tal come <function>error_log</function>.
     </para>
     
     &ini.shorthandbytes;
     
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.ignore-repeated-errors">
    <term>
     <parameter>ignore_repeated_errors</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      No registra mensajes repetidos. Los mensajes repetidos deben ocurrir en la misma
      línea del mismo fichero a menos que
      <link linkend="ini.ignore-repeated-source">ignore_repeated_source</link>
      esté establecido a true.
     </para>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.ignore-repeated-source">
    <term>
     <parameter>ignore_repeated_source</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      Ignora el origen del mensaje cuando se ignoran mensajes repetidos. Cuando este ajuste
      está activado (On) no se registrarán errores con mensajes repetidos de diferentes ficheros o
      líneas del código fuente.
     </para>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.report-memleaks">
    <term>
     <parameter>report_memleaks</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      Si este parámetro está activado (On), que es lo predeterminado, mostrará un
      informe de pérdidas de memoria detectado por el gestor de memoria Zend. Este informe
      será enviado a stderr en las plataformas Posix. En Windows, será enviado
      al depurador usando OutputDebugString(), y podrá ser visto con herramientas
      como <link xlink:href="&url.dbgview;">DbgView</link>.
      Este parámetro solo tiene efecto en una versión de depuración, y si
      error_reporting incluye <constant>E_WARNING</constant> en la lista
      permitida.
     </para>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.track-errors">
    <term>
     <parameter>track_errors</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      Si está habilitado, el último mensaje de error siempre estará presente en la
      variable <varname>$php_errormsg</varname>.
     </para>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.html-errors">
    <term>
     <parameter>html_errors</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      Si se habilita, los mensajes de error incluirán etiquetas HTML. El formato para los errores
      HTML produce mensajes clicables que dirigen al usuario a una página
      que describe el error o función que causó el error. Estas referencias
      se ven afectadas por
      <link linkend="ini.docref-root">docref_root</link> y
      <link linkend="ini.docref-ext">docref_ext</link>.
     </para>
     <para>
      Si se inhabilita, el mensaje de error será solamente texto plano.
     </para>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.xmlrpc-errors">
    <term>
     <parameter>xmlrpc_errors</parameter>
     <type>boolean</type>
    </term>
    <listitem>
     <para>
      Si se habilita, se desactiva el reporte de errores normal y se formatean 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>integer</type>
    </term>
    <listitem>
     <para>
      Usado como el valor del elemento faultCode de XML-RPC.
     </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 que describe el error o a la
      función que causa el error. En caso de páginas de manual, se puede descargar el
      manual en su idioma y establecer esta directiva ini al URL de su copia
      local. Si a su copia local del manual se puede llegar mediante <literal>"/manual/"</literal>
      puede usar simplemente <userinput>docref_root=/manual/</userinput>. Además tiene
      que establecer docref_ext para que coincida con las extensiones de fichero de su copia
      <userinput>docref_ext=.html</userinput>. Es posible usar referencias
      externas. Por ejemplo, se puede usar
      <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 será necesario que el valor de docref_root termine con una barra <literal>"/"</literal>.
      Sin embargo, veáse el segundo ejemplo de antes, el cuál ni la tiene ni la necesita.
     </para>
     <note>
      <para>
       Esta es una característica para ayudar al desarrollo, ya que hace más fácil
       buscar una descripción de una función. Sin embargo, nunca debería usarse en
       sistemas de producción (p.ej. en sistemas conectados a internet).
      </para>
     </note>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.docref-ext">
    <term>
     <parameter>docref_ext</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Véase <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>
      String a imprimir antes de un 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>
      String a imprimir después de un 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 fichero donde los errores del script deberían ser registrados. El fichero debería
      ser modificable por el usuario del servidor web. Si se usa el
      valor especial <literal>syslog</literal>, los errores
      son enviados en su lugar al registro del sistema. En Unix, esto quiere decir
      syslog(3) y en Windows quiere decir el registro de sucesos. Véase también:
      <function>syslog</function>.
      Si esta directiva no está establecida, los errores se enviarán al registro de error de la SAPI. 
      Por ejemplo, un registro de error en Apache o <literal>stderr</literal>
      en CLI.
      Véase también <function>error_log</function>.
     </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 está registrando el mensaje.
      Solamente efectivo si <link linkend="ini.error-log">error_log</link> se establece a "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 a aplicar a los mensajes registrados. Los caracteres
      pertimitos se pasan sin modificar; los demás se escriben en su 
      representación hexadecimal prefijados con <literal>\x</literal>. Existen
      tres tipos de filtro permitidos:
      <itemizedlist>
       <listitem>
        <simpara><literal>all</literal> – todos los caracteres</simpara>
       </listitem>
       <listitem>
        <simpara><literal>no-ctrl</literal> – todos los caracteres excepto los de control</simpara>
       </listitem>
       <listitem>
        <simpara><literal>ascii</literal> – todos los caracteres ASCII imprimibles y <literal>NL</literal></simpara>
       </listitem>
      </itemizedlist>
      Solamente efectivo si <link linkend="ini.error-log">error_log</link> se establece a "syslog".
     </para>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.syslog.ident">
    <term>
     <parameter>syslog.ident</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Especifica la cadena de sangrado que antecede a todo mensaje.
      Solamente efectivo si <link linkend="ini.error-log">error_log</link> se establece a "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
-->