(PHP 4 >= 4.0.1, PHP 5, PHP 7)
trigger_error — Gera uma mensagem a nível de usuário de erro/aviso/notícia
$error_msg
[, int $error_type
= E_USER_NOTICE
] )Usado para realizar uma condição de erro, pode ser usado em conjunto com o manipulador de erro interno, ou com uma função definida pelo usuário que foi definida como novo manipulador de erro (set_error_handler()).
Esta função é útil se você precisa gerar uma resposta em particular para uma exceção em tempo de execução.
error_msg
A mensagem de erro definida para este erro. É limitada a 1024 caracteres em tamanho. Quaisquer caracteres além de 1024 serão truncados.
error_type
O tipo de erro definido para este erro. Funciona apenas com a família de constantes
E_USER, e o padrão será E_USER_NOTICE
.
Esta função retorna FALSE
se for especificado error_type
errado, TRUE
se não.
Exemplo #1 Exemplo trigger_error()
Veja set_error_handler() para um exemplo mais extensivo.
<?php
if (assert($divisor == 0)) {
trigger_error("Cannot divide by zero", E_USER_ERROR);
}
?>
As entidades HTML contidas no parâmetro error_msg
não são escapadas. Utilize htmlentities() na mensagem
para que o erro seja exibido no navegador.