mirror of
https://github.com/php/doc-es.git
synced 2026-03-25 16:02:13 +01:00
70b5280f53
git-svn-id: https://svn.php.net/repository/phpdoc/es/trunk@337300 c90b9560-bf6c-de11-be94-00142212c4b1
515 lines
18 KiB
XML
515 lines
18 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- $Revision$ -->
|
|
<!-- EN-Revision: dc2135dccf125e2b335522efee53cdb80b133226 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 <= 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 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> &
|
|
~<constant>E_NOTICE</constant> &
|
|
~<constant>E_STRICT</constant> &
|
|
~<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> &
|
|
~<constant>E_NOTICE</constant> &
|
|
~<constant>E_STRICT</constant>.
|
|
en PHP, el valor predeterminado es <constant>E_ALL</constant>
|
|
& ~<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 < 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>
|
|
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 se ven
|
|
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 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>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 posbile usar referencias
|
|
externas. Por ejemplo, se 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 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 NT quiere decir el registro de sucesos. El
|
|
registro de sistema no está admitido en Windows 95. 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>
|
|
|
|
</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
|
|
-->
|