El comportamiento de estas funciones se ve afectado por la configuración de php.ini.
| Nombre | Por defecto | Cambiable | Historial de cambios |
|---|---|---|---|
| error_reporting | NULL | INI_ALL | |
| display_errors | "1" | INI_ALL | |
| display_startup_errors | "0" | INI_ALL | |
| log_errors | "0" | INI_ALL | |
| log_errors_max_len | "1024" | INI_ALL | Disponible a partir de PHP 4.3.0. |
| ignore_repeated_errors | "0" | INI_ALL | Disponible a partir de PHP 4.3.0. |
| ignore_repeated_source | "0" | INI_ALL | Disponible a partir de PHP 4.3.0. |
| report_memleaks | "1" | INI_ALL | Disponible a partir de PHP 4.3.0. |
| track_errors | "0" | INI_ALL | |
| html_errors | "1" | INI_ALL | INI_SYSTEM en PHP <= 4.2.3. |
| xmlrpc_errors | "0" | INI_SYSTEM | Disponible a partir de PHP 4.1.0. |
| xmlrpc_error_number | "0" | INI_ALL | Disponible a partir de PHP 4.1.0. |
| docref_root | "" | INI_ALL | Disponible a partir de PHP 4.3.0. |
| docref_ext | "" | INI_ALL | Disponible a partir de PHP 4.3.2. |
| error_prepend_string | NULL | INI_ALL | |
| error_append_string | NULL | INI_ALL | |
| error_log | NULL | INI_ALL | |
| error_log_mode | 0o644 | INI_ALL | Disponible a partir de PHP 8.2.0 |
| syslog.facility | "LOG_USER" | INI_SYSTEM | Disponible a partir de PHP 7.3.0. |
| syslog.filter | "no-ctrl" | INI_ALL | Disponible a partir de PHP 7.3.0. |
| syslog.ident | "php" | INI_SYSTEM | Disponible a partir de PHP 7.3.0. |
He aquí una breve explicación de las directivas de configuración.
error_reportingintegerEstablece 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 Constantes predefinidas, y en php.ini. Para establecerlo en tiempo de ejecución, se ha de usar la función error_reporting(). Vése también la directiva display_errors.
En PHP 5.3 o posterior, el valor predeterminado es E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED. Este ajuste no muestra los niveles de error E_NOTICE, E_STRICT y E_DEPRECATED. Quizás quiera mostrarlos durante el desarrollo. Antes de PHP 5.3.0, el valor predeterminado es E_ALL & ~E_NOTICE & ~E_STRICT. en PHP, el valor predeterminado es E_ALL & ~E_NOTICE.
Nota:
La habilitación de
E_NOTICEdurante 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,$arr[item]es mejor que sea escrito como$arr['item']ya que PHP intenta tratar"item"como una constante. Si no es una constante, PHP asume que es un índice de string del array.
Nota:
En PHP 5 está disponible el nuevo nivel de error
E_STRICT. Antes de PHP 5.4.0,E_STRICTno estaba incluido dentro deE_ALL, por lo que se teniía de habilitar explícitamente este tipo de nivel de error en PHP < 5.4.0. La habilitación deE_STRICTdurante 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 erroresE_STRICTcomo asignar objetos por referencias durante la instanciación.
Nota: Constantes de PHP fuera de PHP
El uso de constantes de PHP fuera de PHP, como en httpd.conf, no tiene un propósito útil, por lo que, en tales casos, se requerirán los valores de tipo integer. Y ya que se añadirán más niveles de error en el futuro, el valor máximo (para
E_ALL) cambiará igualmente. Por lo que, en lugar deE_ALLse 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 como2147483647(incluye todos los errores, no sóloE_ALL).
display_errorsstringDetermina si los errores deberían ser impresos en pantalla como parte de la salida o si deberían ocultarse al usuario.
El valor "stderr" envía los errores a stderr en vez de a stdout. Este valor está disponible a partir de PHP 5.2.4. En versiones anteriores esta directiva era de tipo boolean.
Nota:
É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).
Nota:
Aunque display_errors puede ser establecido en tiempo de ejecución (con ini_set()), 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.
display_startup_errorsbooleanIncluso 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.
log_errorsbooleanIndica si los mensajes de error del script deberían de registrarse en el registro del servidor o en error_log. Esta opción es, por lo tanto, específica para servidores.
Nota:
Se aconseja encarecidamente usar el registro de errores en lugar de mostrar los errores en sitios web de producción.
log_errors_max_lenintegerEstablece la longitud máxima de log_errors en bytes. En error_log 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 $php_errormsg, pero no a las funciones llamadas explícitamente tal come error_log().
Cuando se usa un integer, el valor del mismo es medido en bytes. También se puede usar la notación reducida, tal como se describe en esta FAQ.ignore_repeated_errorsbooleanNo registra mensajes repetidos. Los mensajes repetidos deben ocurrir en la misma línea del mismo fichero a menos que ignore_repeated_source esté establecido a true.
ignore_repeated_sourcebooleanIgnora 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.
report_memleaksboolean 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 » DbgView. Este parámetro solo tiene efecto en una versión de depuración, y si error_reporting incluye E_WARNING en la lista permitida.
track_errorsbooleanSi está habilitado, el último mensaje de error siempre estará presente en la variable $php_errormsg.
html_errorsbooleanSi 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 docref_root y docref_ext.
Si se inhabilita, el mensaje de error será solamente texto plano.
xmlrpc_errorsbooleanSi se habilita, se desactiva el reporte de errores normal y se formatean los errores como mensajes de error XML-RPC.
xmlrpc_error_numberintegerUsado como el valor del elemento faultCode de XML-RPC.
docref_rootstring 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 "/manual/" puede usar simplemente docref_root=/manual/. Además tiene que establecer docref_ext para que coincida con las extensiones de fichero de su copia docref_ext=.html. Es posible usar referencias externas. Por ejemplo, se puede usar docref_root=http://manual/en/ o docref_root="http://landonize.it/?how=url&theme=classic&filter=Landon &url=http%3A%2F%2Fwww.php.net%2F"
La mayoría de las veces será necesario que el valor de docref_root termine con una barra "/". Sin embargo, veáse el segundo ejemplo de antes, el cuál ni la tiene ni la necesita.
Nota:
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).
docref_extstringVéase docref_root.
Nota:
El valor de docref_ext debe comenzar con un punto
".".
error_prepend_stringstringString a imprimir antes de un mensaje de error.
error_append_stringstringString a imprimir después de un mensaje de error.
error_logstring 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 syslog, 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: syslog(). 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 stderr en CLI. Véase también error_log().
error_log_modeintFile mode for the file described set in error_log.
syslog.facilitystringEspecifica el tipo de programa que está registrando el mensaje. Solamente efectivo si error_log se establece a "syslog".
syslog.filterstring 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 \x. Existen tres tipos de filtro permitidos:
all – todos los caracteresno-ctrl – todos los caracteres excepto los de controlascii – todos los caracteres ASCII imprimibles y NLsyslog.identstringEspecifica la cadena de sangrado que antecede a todo mensaje. Solamente efectivo si error_log se establece a "syslog".