Funciones de error y registro en PHP

Introducción a PHP Error

Las funciones de Error y Logging permiten manejar y registrar errores.

Las funciones de error permiten a los usuarios definir reglas de manejo de errores y modificar la forma en que se registran los errores.

Las funciones de registro permiten a los usuarios registrar aplicaciones y enviar mensajes de registro a correos electrónicos, registros del sistema o otras máquinas.

Las funciones de error se utilizan para completar el manejo de errores y el registro.

Las funciones de error nos permiten definir nuestras propias reglas de manejo de errores y modificar la forma en que se registran los errores.

Las funciones de registro nos permiten enviar mensajes directamente a otras máquinas, correos electrónicos o registros del sistema.

Las funciones de reporte de errores nos permiten especificar el tipo y el nivel de los errores.

Instalación

Las funciones de error de PHP son parte del núcleo de PHP. No es necesario instalarlas para usar estas funciones.

Configuración de tiempo de ejecución

El comportamiento de la función error está influenciado por la configuración en php.ini.

Las opciones de configuración de errores y registro son las siguientes:

Nombre Valor predeterminado Descripción Rango modifiable
error_reporting NULL Establece el nivel de reporte de errores (entero o constante nombrada). PHP_INI_ALL
display_errors "1"

Determina si los errores deben mostrarse en la pantalla como salida o ocultarse al usuario.

Atención:Esta característica no debe utilizarse en sistemas de producción (solo soporte de desarrollo).

 PHP_INI_ALL
display_startup_errors "0"

Aún si display_errors está configurado como activado, los errores del proceso de inicio de PHP no se mostrarán.

Notas: Se recomienda encarecidamente que, excepto para fines de depuración, se configure display_startup_errors como desactivado.

 PHP_INI_ALL
log_errors "0"

Establece si se deben registrar los errores del script en el registro de errores del servidor o en error_log.

Notas: Esta es una configuración específica relacionada con el servidor.

Notas: Se recomienda encarecidamente que en sistemas de producción utilices la registro de errores de la información de errores mostrados en el sitio web.

 PHP_INI_ALL
log_errors_max_len "1024"

Establece el número máximo de bytes para log_errors. En error_log se agregarán información sobre la fuente de los errores.

El valor predeterminado es 1024, si se establece en 0, no hay límite de longitud.

La configuración de longitud tiene un efecto limitante en los errores registrados, los errores mostrados y $php_errormsg.

 PHP_INI_ALL
ignore_repeated_errors "0"

Especifica si se deben registrar mensajes de error repetidos.

Los errores repetidos deben aparecer en la misma línea de código del mismo archivo, a menos que ignore_repeated_source se establezca en true.

 PHP_INI_ALL
ignore_repeated_source "0"

Especifica si se deben registrar mensajes de error repetidos. Al ignorar mensajes repetidos, también se ignora la fuente de los mensajes.

Cuando se habilita esta configuración, no se registrará información repetida, ya sea que se genere por diferentes archivos o diferentes líneas de código.

 PHP_INI_ALL
report_memleaks "1" Si este parámetro se establece en On (por defecto), se mostrarán los informes de fugas de memoria detectadas por el administrador de memoria Zend. PHP_INI_ALL
track_errors "0" Si se habilita, el último error siempre estará presente en la variable $php_errormsg. PHP_INI_ALL
html_errors "1" Deshabilita las etiquetas HTML en la información de errores.
  • PHP_INI_ALL
  • PHP_INI_SYSTEM en PHP <= 4.2.3.
xmlrpc_errors "0" Si se habilita, desactiva el informe normal de errores y configura el formato de errores en el formato de información de errores XML-RPC. PHP_INI_SYSTEM
xmlrpc_error_number "0" Se utiliza como valor del elemento faultCode en XML-RPC. PHP_INI_ALL
docref_root "" (disponible desde PHP 4.3) PHP_INI_ALL
docref_ext "" (disponible desde PHP 4.3.2) PHP_INI_ALL
error_prepend_string NULL Especifica la cadena que se debe imprimir antes de la información de error. PHP_INI_ALL
error_append_string NULL Especifica la cadena que se debe imprimir después de la información de error. PHP_INI_ALL
error_log NULL

Establece el archivo en el que se registrarán los errores del script. Este archivo debe ser accesible para el usuario del servidor web.

Si se utiliza el valor especial syslog, envía la información de errores al registrador de sistema.

 PHP_INI_ALL

Funciones de error y registro en PHP

Función Descripción
debug_backtrace() Genera el backtrace.
debug_print_backtrace() Imprime el backtrace.
error_get_last() Devuelve el último error ocurrido.
error_log() Envía mensajes de error al registro de errores del servidor, archivo o destino remoto.
error_reporting() Especifica qué errores se deben informar.
restore_error_handler() Recupera el programa de manejo de errores anterior.
restore_exception_handler() Recuperar el gestor de excepciones anterior.
set_error_handler() Establecer la función de manejo de errores personalizada.
set_exception_handler() Establecer la función de manejo de excepciones personalizada.
trigger_error() Crear mensajes de error de nivel de usuario.
user_error() Alias de trigger_error()

Constantes predefinidas de errores y registro de PHP 5

Valor Constante Descripción
1 E_ERROR Errores fatales en tiempo de ejecución. Errores que no se pueden reparar. Detienen la ejecución del script.
2 E_WARNING Errores no fatales en tiempo de ejecución. No detienen la ejecución del script.
4 E_PARSE Errores de análisis de sintaxis en tiempo de compilación. Los errores de análisis se generan solo por el analizador.
8 E_NOTICE Notificaciones en tiempo de ejecución. Indica que el script se encuentra en una situación que podría manifestarse como un error, pero también podría haber notificaciones similares en un script que se ejecuta correctamente.
16 E_CORE_ERROR Errores fatales en el proceso de inicialización de PHP. Este error es similar a E_ERROR, pero generado por el núcleo del motor PHP.
32 E_CORE_WARNING Advertencias en el proceso de inicialización de PHP (errores no fatales). Similar a E_WARNING, pero generadas por el núcleo del motor PHP.
64 E_COMPILE_ERROR Errores fatales en tiempo de compilación. Similar a E_ERROR, pero generados por el motor de script Zend.
128 E_COMPILE_WARNING Advertencias en tiempo de compilación (errores no fatales). Similar a E_WARNING, pero generadas por el motor de script Zend.
256 E_USER_ERROR Mensajes de error generados por el usuario. Similar a E_ERROR, pero generados por el usuario mismo en el código utilizando la función PHP trigger_error().
512 E_USER_WARNING Notificaciones de advertencia generadas por el usuario. Similar a E_WARNING, pero generadas por el usuario mismo en el código utilizando la función PHP trigger_error().
1024 E_USER_NOTICE Notificaciones de información generadas por el usuario. Similar a E_NOTICE, pero generadas por el usuario mismo en el código utilizando la función PHP trigger_error().
2048 E_STRICT Habilitar la sugerencia de modificación de código de PHP para asegurar que el código tenga la mejor interoperabilidad y compatibilidad hacia adelante.
4096 E_RECOVERABLE_ERROR Errores fatales capturables. Esto indica que se produjo un error muy peligroso, pero que aún no ha llevado a un estado inestable del motor PHP. Si el error no es capturado por el gestor de errores personalizado del usuario (ver set_error_handler()), se convertirá en un E_ERROR y el script se detendrá.
8192 E_DEPRECATED Notificaciones en tiempo de ejecución. Al activarse, se emitirán advertencias sobre el código que puede no funcionar correctamente en versiones futuras.
16384 E_USER_DEPRECATED Advertencias generadas por el usuario. Similar a E_DEPRECATED, pero generadas por el usuario mismo al usar la función PHP trigger_error() en el código.
32767 E_ALL E_STRICT todos los errores y advertencias excepto los de E_ALL.