mirror of
https://github.com/php/doc-es.git
synced 2026-03-28 17:32:16 +01:00
f8c97dc53c
git-svn-id: https://svn.php.net/repository/phpdoc/es/trunk@302848 c90b9560-bf6c-de11-be94-00142212c4b1
494 lines
17 KiB
XML
494 lines
17 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- $Revision: 297028 $ -->
|
|
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: seros Status: ready -->
|
|
<section xml:id="errorfunc.configuration" xmlns="http://docbook.org/ns/docbook">
|
|
&reftitle.runtime;
|
|
&extension.runtime;
|
|
<para>
|
|
<table>
|
|
<title>Opciones de Configuración de Errores y Registro</title>
|
|
<tgroup cols="4">
|
|
<thead>
|
|
<row>
|
|
<entry>Nombre</entry>
|
|
<entry>Predeterminado</entry>
|
|
<entry>Variable</entry>
|
|
<entry>Registro de Cambios</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 <= 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>
|
|
</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 un valor de tipo
|
|
integer que representa un campo de bits, o constantes nominadas. Los niveles de error_reporting
|
|
y constantes están descritos en
|
|
<link linkend="errorfunc.constants">Constantes Predefinidas</link>,
|
|
y en &php.ini;. Para establecerlo en tiempo de ejecución, use la
|
|
función <function>error_reporting</function>. Vea también la
|
|
directiva <link linkend="ini.display-errors">display_errors</link>.
|
|
</para>
|
|
<para>
|
|
En PHP 4 y PHP 5 el valor predeterminado es <constant>E_ALL</constant>
|
|
& ~<constant>E_NOTICE</constant>.
|
|
Esta configuración no muestra los errores de nivel <constant>E_NOTICE</constant>.
|
|
Puede querer mostrarlos durante el desarrollo.
|
|
</para>
|
|
<note>
|
|
<para>Habilitar <constant>E_NOTICE</constant> durante el desarrollo tiene
|
|
algunos beneficios. Para depuración: los mensajes NOTICE le avisarán
|
|
de posibles errores en su código. Por ejemplo, se avisa del uso de valores no
|
|
asignados. Es extremadamente útil para encontrar errartas y
|
|
ahorrar tiempo de depuración. Los mensajes NOTICE le avisarán sobre 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 cadena del array.
|
|
</para>
|
|
</note>
|
|
<note>
|
|
<para>
|
|
En PHP 5 está disponible el nuevo nivel de error <constant>E_STRICT</constant>.
|
|
Ya que <constant>E_STRICT</constant> no está incluido dentro de
|
|
<constant>E_ALL</constant> tiene que habilitar explícitamente este tipo
|
|
de nivel de error. Habilitar <constant>E_STRICT</constant> durante el desarrollo
|
|
tiene algunos beneficios. Los mensajes STRICT le ayudarán a usar el último y
|
|
más sugerente método de codificación, por ejemplo le advertirá del uso
|
|
de funciones obsoletas.
|
|
</para>
|
|
</note>
|
|
<note>
|
|
<title>Constantes de PHP fuera de PHP</title>
|
|
<para>
|
|
Usar constantes de PHP fuera de PHP, como en <filename>httpd.conf</filename>,
|
|
no tendrá 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 con el tiempo, el valor
|
|
máximo (para <constant>E_ALL</constant>) cambiará igualmente. Por lo que en lugar de
|
|
<constant>E_ALL</constant> considere usar un valor grande para cubrir todos los campos
|
|
de bits desde ahora 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>. El valor está disponible a partir de PHP
|
|
5.2.4. En versiones anteriores esta directiva era de tipo <type>boolean</type>.
|
|
</para>
|
|
<note>
|
|
<para>
|
|
Esta es una característica para apoyar su desarrollo y nunca debería usarse
|
|
es sistemas de producción (p.ej. 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 porque la acción en tiempo de ejecución deseada 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 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
|
|
de la fuente. 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>.
|
|
</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 el misma
|
|
línea del mismo archivo 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 la fuente del mensaje cuando se ignoran mensajes repetidos. Cuando este ajuste
|
|
está activado (On) no se registrarán errores con mensajes repetidos de diferentes archivos o
|
|
líneas 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á desactivado (Off), no se mostrarán las filtraciones de memoria (en
|
|
stdout o en el registro). Sólo tiene efecto en una compilación de depuración, y si
|
|
<link linkend="ini.error-reporting">error_reporting</link> 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>
|
|
Desactiva las etiquetas HTML en los mensajes de error. El nuevo formato para errores HTML
|
|
producen mensajes clicables que dirigen al usuario a una página describiendo
|
|
el error o a la función que causa 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>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry xml:id="ini.xmlrpc-errors">
|
|
<term>
|
|
<parameter>xmlrpc_errors</parameter>
|
|
<type>boolean</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Desactiva la notificación de errores normal y fortamea 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 la página describiendo el error o a la
|
|
función que causa el error. En caso de páginas de manual puede descargar el
|
|
manual en su idioma y establecer esta directiva ini a la URL de su copia
|
|
local. Si su copia local del manual se puede alcanzar 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 archivo de su copia
|
|
<userinput>docref_ext=.html</userinput>. Es posbile usar referencias
|
|
externas. Por ejemplo puede usar
|
|
<userinput>docref_root=http://manual/en/</userinput> o
|
|
<userinput>docref_root="http://landonize.it/?how=url&theme=classic&filter=Landon
|
|
&url=http%3A%2F%2Fwww.php.net%2F"</userinput>
|
|
</para>
|
|
<para>
|
|
La mayoría de las veces querrá que el valor de docref_root termine con una barra <literal>"/"</literal>.
|
|
Pero vea el segundo ejemplo de arriba, el cuál no la tiene ni la necesita.
|
|
</para>
|
|
<note>
|
|
<para>
|
|
Esta es una característica para apoyar su 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. 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>
|
|
Cadena 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>
|
|
Cadena 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 archivo donde los errores del script deberían ser registrados. El archivo 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 NT quiere decir el registro de sucesos. El
|
|
registro de sistema no está soportado en Windows 95. Vea también:
|
|
<function>syslog</function>.
|
|
Si esta directiva no está establecida los errores se enviarán al registro de error de SAPI.
|
|
Por ejemplo, un registro de error en Apache o <literal>stderr</literal>
|
|
en CLI.
|
|
</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
|
|
-->
|