(PHP 4 >= 4.0.1, PHP 5)
trigger_error — Generar un mensaje de error/advertencia/aviso de nivel de usuario
$error_msg
[, int $error_type
= E_USER_NOTICE
] )Se usa para provocar una condición de error de usuario, se puede utilizar junto con el gestor de errores interno o con una función definida por el usuario que ha sido establecida como el nuevo gestor de errores ( set_error_handler()).
Esta función es útil cuando se necesita generar una respuesta en particular a una excepción en tiempo de ejecución.
error_msg
El mensaje de error designado para este error. Está limitado a 1024 bytes de longitud. Cualquier carácter más allá de los 1024 será truncado.
error_type
El tipo de error designado para este error. Sólo funciona con la familia de constantes
E_USER, y por defecto es E_USER_NOTICE
.
Esta función devuelve FALSE
si se especifica un error_type
erróneo, si no TRUE
.
Ejemplo #1 Ejemplo de trigger_error()
Véase set_error_handler() para un ejemplo más extenso.
<?php
if ($divisor == 0) {
trigger_error("No se puede dividir por cero", E_USER_ERROR);
}
?>
Las entidades HTML en error_msg
no son
escapadas. Use htmlentities() en el mensaje si
el error se va a mostrar en un navegador.