PHP set_error_handler()Función
Manual de referencia completo de errores de PHP
Definición y uso
La función set_error_handler() establece una función de manejo de errores personalizada por el usuario.
Esta función se utiliza para crear el propio método de manejo de errores del usuario durante la ejecución.
Esta función devuelve el manejador de errores anterior; si falla, devuelve NULL.
Sintaxis
set_error_handler(error_function,error_types)
| Parámetros | Descripción |
|---|---|
| error_function | Obligatorio. Especifica la función que se ejecuta cuando ocurre un error. |
| error_types | Opcional. Especifica en qué nivel de reporte de errores se mostrarán los errores definidos por el usuario. El valor predeterminado es "E_ALL". Consulte la tabla siguiente para ver los posibles niveles de reporte de errores. |
error_function
Sintaxis
error_function(error_level,error_message,
error_file,error_line,error_context)
error_file,error_line,error_context)
| Parámetros | Descripción |
|---|---|
| error_level | Obligatorio. Especifica el nivel de reporte de errores para el error definido por el usuario. Debe ser un valor numérico. Consulte la tabla siguiente para ver los posibles niveles de reporte de errores. |
| error_message | Obligatorio. Especifica el mensaje de error del error definido por el usuario. |
| error_file | Opcional. Especifica el nombre del archivo donde ocurrió el error. |
| error_line | Opcional. Especifica el número de línea donde ocurrió el error. |
| error_context | Opcional. Especifica un array que apunta a la tabla de símbolos activa donde ocurrió el error. En otras palabras, error_context contendrá un array que describe el ámbito en el que cada variable provocó el error. |
Niveles de reporte de errores
| Valor | Constante | Descripción |
|---|---|---|
| 2 | E_WARNING | Error no fatal en tiempo de ejecución. No detiene la ejecución del script. |
| 8 | E_NOTICE | Aviso en tiempo de ejecución. El script detecta que posiblemente hay un error, pero también puede ocurrir durante la ejecución normal del script. |
| 256 | E_USER_ERROR | Error fatal generado por el usuario. Es como el E_ERROR generado por el programador mediante la función PHP trigger_error(). |
| 512 | E_USER_WARNING | Error no fatal generado por el usuario. Es como el E_WARNING generado por el programador mediante la función PHP trigger_error(). |
| 1024 | E_USER_NOTICE | Aviso generado por el usuario. Es como el E_NOTICE generado por el programador mediante la función PHP trigger_error(). |
| 4096 | E_RECOVERABLE_ERROR | Error fatal capturable. Es como un E_ERROR que puede ser capturado por un manejador definido por el usuario (ver set_error_handler()). |
| 8191 | E_ALL | Todos los niveles de errores y advertencias, excepto E_STRICT (a partir de PHP 6.0, E_STRICT será parte de E_ALL). |
Consejos y notas
Consejo:Si se utiliza esta función, se omitirán por completo las funciones estándar de manejo de errores de PHP. Si es necesario, el manejador de errores definido por el usuario debe terminar el script (die()).
Nota:Si se produce un error antes de la ejecución del script, este manejador de errores personalizado no se utilizará porque el programa personalizado aún no se ha registrado en ese momento.
Ejemplos
<?php
//error handler function
function customError($errno, $errstr, $errfile, $errline)
{
echo "<b>Custom error:</b> [$errno] $errstr<br />";
echo " Error on line $errline in $errfile<br />";
echo "Ending Script";
die();
}
//set error handler
set_error_handler("customError");
$test=2;
//trigger error
if ($test>1)
{
trigger_error("A custom error has been triggered");
}
?>
//error handler function
function customError($errno, $errstr, $errfile, $errline)
{
echo "<b>Custom error:</b> [$errno] $errstr<br />";
echo " Error on line $errline in $errfile<br />";
echo "Ending Script";
die();
}
//set error handler
set_error_handler("customError");
$test=2;
//trigger error
if ($test>1)
{
trigger_error("A custom error has been triggered");
}
?>
La salida del código anterior se muestra a continuación:
Custom error: [1024] A custom error has been triggered
Error on line 19 in C:webfoldertest.php
Ending Script
Error on line 19 in C:webfoldertest.php
Ending Script
Manual de referencia completo de errores de PHP Otras extensiones