trigger_error

(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)

trigger_errorDesencadena un error de usuario

Descripción

trigger_error(string $message, int $error_level = E_USER_NOTICE): true

trigger_error() se utiliza para desencadenar un error de usuario. También puede ser utilizada en conjunción con un manejador de errores interno, o un manejador de errores de usuario que haya sido seleccionado como manejador de errores con set_error_handler().

trigger_error() es práctico cuando se debe generar una respuesta particular durante la ejecución.

Parámetros

message

El mensaje de error designado para este error. Está limitado en longitud a 1024 bytes. Todos los caracteres después de los 1024 bytes serán ignorados.

error_level

El tipo de error designado para este error. Solo funciona con la familia de constantes E_USER_* y será por omisión E_USER_NOTICE.

Advertencia

Pasar E_USER_ERROR como error_level está ahora deprecado. Lance una Exception o llame a exit() en su lugar.

Valores devueltos

Siempre devuelve true.

Errores/Excepciones

Esta función lanza una ValueError si el error_level no es uno de los E_USER_ERROR, E_USER_WARNING, E_USER_NOTICE, E_USER_DEPRECATED.

Historial de cambios

Versión Descripción
8.4.0 Pasar E_USER_ERROR como error_level está ahora deprecado. Lance una Exception o llame a exit() en su lugar.
8.4.0 La función tiene ahora un tipo de retorno true en lugar de bool.
8.0.0 La función lanza ahora una ValueError si se especifica un error_level inválido. Anteriormente, devolvía false.

Ejemplos

Ejemplo #1 Ejemplo con trigger_error()

Ver set_error_handler() para un ejemplo más sustancial.

<?php
$password
= $_POST['password'] ?? '';
if (
$password === '') {
trigger_error("Usar una contraseña vacía no es seguro", E_USER_WARNING);
}
$hash = password_hash($password, PASSWORD_DEFAULT);
?>

Notas

Advertencia

Las entidades HTML contenidas en el parámetro message no son escapadas. Utilice la función htmlentities() en el mensaje si el error debe ser mostrado en un navegador.

Ver también