(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)
trigger_error — Desencadena un error de usuario
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.
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
.
Pasar E_USER_ERROR
como
error_level
está ahora deprecado.
Lance una Exception o
llame a exit() en su lugar.
Siempre devuelve true
.
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
.
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 .
|
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);
?>
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.