Usa para realizar uma condição de erro, pode ser usado em conjunto com o gerenciador de erros padrão ou com uma função definida pelo usuário, se for definida como gerenciador de erros com set_error_handler(). Somente funciona com as constantes da família E_USER, e o padrão é E_USER_NOTICE.
Esta função é útil quando você quer gerar uma resposta para uma exceção durante a execução do script. Por exemplo:
Nota: Veja set_error_handler() para um exemplo maior.
Nota: error_msg é limitado a 1024 caracteres de tamanho. Qualquer caractere adicional além de 1024 serão truncados.
Veja também error_reporting(), set_error_handler(), restore_error_handler() e constantes de níveis de erro.