|
(PHP 4 >= 4.0.1, PHP 5)
set_error_handler -- Establece una función de gestión de errores definida por el usuarioEstablece una función de usuario (gestor_errores) para manejar los errores en un script.
Esta función puede ser usada para definir su propia forma de gestionar errores en tiempo de ejecución, por ejemplo en aplicaciones en las que necesita efectuar limpieza de datos/archivos cuando ocurre en error crítico, o cuando necesita generar un error bajo ciertas condiciones (usando trigger_error()).
Es importante recordar que el gestor de errores estándar de PHP es completamente ignorado. Los parámetros de error_reporting() no tendrán efecto alguno y su gestor de errores será llamado en cualquier circunstancia - sin embargo es posible leer el valor actual de error_reporting y actuar apropiadamente. Es particularmente importante notar que este valor será 0 si la sentencia que causó el error fue precedida por el operador de control de errores @.
Note también que es su responsabilidad usar die() si es necesario. Si la función de gestión de errores retorna, la ejecución del script continuará con la siguiente sentencia después de aquélla que causó el error.
Los siguientes tipos de error no pueden ser gestionados con una función definida por el usuario: E_ERROR, E_PARSE, E_CORE_ERROR, E_CORE_WARNING, E_COMPILE_ERROR, E_COMPILE_WARNING, y la mayoría de E_STRICT generados en el archivo en donde set_error_handler() es llamado.
Si ocurren errores antes de que el script es ejecutado (p.ej. cuando se cargan archivos desde una página web) el gestor de errores personalizado no puede ser llamado ya que no está registrado en ese momento.
La función de usuario necesita aceptar dos parámetros: el código de error, y una cadena que describa el error. Luego hay tres parámetros opcionales que pueden entregarse: el nombre del archivo en el que ocurrió el error, el número de línea en el que ocurrió el error, y el contexto en el que ocurrió el error (una matriz que apunta a la tabla activa de símbolos en el punto en el que ocurrió el error). La función puede mostrarse como:
gestor ( int num_err, string cadena_err [, string archivo_err [, int linea_err [, array contexto_err]]] )
El primer parámetro, num_err, contiene el nivel del error generado, como un entero.
El segundo parámetro, cadena_err, contiene el mensaje de error, como una cadena.
El tercer parámetro es opcional, archivo_err, el cual contiene el nombre del archivo en el que se generó el error, como una cadena.
El cuarto parámetro es opcional, linea_err, el cual contiene el número de línea en la que se generó el error, como un entero.
El quinto parámetro es opcional, contexto_err, el cual es una matriz que apunta a la tabla activa de símbolos en el punto en el que ocurrió el error. En otras palabras, contexto_err contendrá una matriz de todas las variables que existieron en el contexto en el que ocurrió el error.
Puede ser usado para aplicar una máscara a las llamadas de la función error_handler tal y como el parámetro ini error_reporting controla qué errores son mostrados. Sin esta máscara definida, el gestor_errores será llamado para cada error sin importar el valor del parámetro error_reporting.
Devuelve una cadena que contiene el gestor de errores previamente definido (si lo hay), o FALSE en caso de error. Si el gestor previo era un método de clase, esta función devolverá una matriz indexada con la clase y el nombre del método.
Versión | Descripción |
---|---|
5.0.0 | Se introdujo el parámetro tipos_error. |
4.3.0 | En lugar de un nombre de función, también es posible entregar una matriz que contenga una referencia a objeto y un nombre de método como valor de gestor_errores. |
4.0.2 | Se introdujeron tres parámetros opcionales para la función de usuario gestor_errores. Estos son el nombre de archivo, el número de línea, y el contexto. |
Ejemplo 1. Gestión de errores con set_error_handler() y trigger_error() El siguiente ejemplo muestra la gestión de excepciones internas generando errores y manejándolos con una función definida por el usuario:
El resultado del ejemplo seria algo similar a:
|
error_reporting() |
restore_error_handler() |
trigger_error() |
constantes de nivel de error |
information about the callback type |
Hosting by: hurra.com
Generated: 2007-01-26 18:01:06