PHP set_error_handler()Función


PHP Error 参考手册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)

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");
}
?>

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


PHP Error 参考手册Manual de referencia completo de errores de PHP Otras extensiones