trigger_error

(PHP 4 >= 4.0.1, PHP 5)

trigger_error --  Genera un mensaje de error/aviso/notificación a nivel de usuario

Descripción

bool trigger_error ( string error_msg [, int error_type] )

Esta función se utiliza generalmente para lanzar mensajes de error. Se puede usar junto con el manejador de errores interno de PHP o con funciones manejadoras de error creadas por el usuario (set_error_handler()). Solamente funciona con la familia de constantes E_USER y por defecto lo hará con E_USER_NOTICE.

El valor devuelto será FALSE si se especifica un valor de error_type incorrecto y TRUE en cualquier otro caso.

La mayor utilidad de esta función es la de generar respuestas personalizadas a las excepciones en tiempo de ejecución. Por ejemplo:

<?php
if (assert($divisor == 0)) {
  
trigger_error("Cannot divide by zero", E_USER_ERROR);
}
?>

Nota: Puede consultar la función set_error_handler() para ver un ejemplo m´s extenso.

Nota: El parámetro error_msg tiene un límite de 1024 caracteres. La función trunca cualquier valor superior a 1024.

Puede consultar también las funciones error_reporting(), set_error_handler(), restore_error_handler() y las constantes de nivel de error.