(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)
trigger_error — Gera uma mensagem a nível de usuário de erro/alerta/nota
Usado para disparar uma condição de erro, pode ser usado em conjunto com o gerenciador de erro interno, ou com uma função definida pelo usuário que tenha sido definida como novo gerenciador de erro (set_error_handler()).
Esta função é útil quando for necessário gerar uma resposta em particular a uma exceção em tempo de execução.
message
A mensagem de erro designada para este erro. É limitada a 1024 bytes em tamanho. Quaisquer caracteres adicionais além de 1024 bytes serão truncados.
error_level
O tipo de erro designado para este erro. Funciona apenas com a família de constantes
E_USER_*
, e o padrão é E_USER_NOTICE
.
Passar E_USER_ERROR
como o
error_level
agora foi descontinuado.
Alternativamente, uma Exception pode ser lançada ou
exit() pode ser chamada.
Sempre retorna true
.
Esta função lança uma exceção ValueError se
error_level
não for uma das constantes
E_USER_ERROR
, E_USER_WARNING
,
E_USER_NOTICE
ou E_USER_DEPRECATED
.
Versão | Descrição |
---|---|
8.4.0 |
Passar E_USER_ERROR como
error_level agora foi descontinuado.
Alternativamente, uma Exception pode ser lançada
ou exit() pode ser chamada.
|
8.4.0 | A função agora tem um tipo de retorno true ao invés de bool. |
8.0.0 |
A função agora lança uma exceção ValueError se um
error_level inválido for especificado. Anteriormente, retornava false .
|
Exemplo #1 Exemplo de trigger_error()
Consulte set_error_handler() para um exemplo mais extensivo.
<?php
$password = $_POST['password'] ?? '';
if ($password === '') {
trigger_error("Usar uma senha vazia não é seguro", E_USER_WARNING);
}
$hash = password_hash($password, PASSWORD_DEFAULT);
?>
As entidades HTML contidas no parâmetro message
não são escapadas. Utilize htmlentities() na mensagem
se for necessário exibir o erro em um navegador.