(PHP 4, PHP 5, PHP 7, PHP 8)
error_log — Envia uma mensagem de erro para as rotinas de tratamento de erros definidas
$message,$message_type = 0,$destination = null,$additional_headers = nullEnvia uma mensagem de erro para o registro de erros do servidor web ou para um arquivo.
messageA mensagem de erro que deve ser registrada.
message_typeIndica para onde o erro deve ser direcionado. Os possíveis tipos de mensagem são os seguintes:
| 0 |
message é enviado para sistema de logs do PHP, usando
o mecanismo de log do sistema operacional ou um arquivo, dependendo do que
a diretiva de configuração error_log
estiver definida. Esta é a opção padrão.
|
| 1 |
message é enviado por e-mail para o endereço no parâmetro
destination. Este é o único tipo de
mensagem em que o quarto parâmetro,
additional_headers, é utilizado.
|
| 2 | Não é mais uma opção. |
| 3 |
message é adicionada ao arquivo
destination. Uma nova linha não é automaticamente
adicionada ao final da string message.
|
| 4 |
message é enviado diretamente para o manipulador de log do
SAPI.
|
destination
O destino. Seu significado depende do parâmetro
message_type, conforme descrito acima.
additional_headers
Os cabeçalhos adicionais. É usado quando o parâmetro message_type
está definido como 1.
Este tipo de mensagem usa a mesma função interna que
mail() utiliza.
Retorna true em caso de sucesso ou false em caso de falha.
Se message_type for zero, esta função sempre retorna true,
independentemente de o erro poder ser registrado ou não.
| Versão | Descrição |
|---|---|
| 8.0.0 |
destination e
additional_headers agora permitem null.
|
Exemplo #1 Exemplos error_log()
<?php
// Envia uma notificação através do registro do servidor se não conseguirmos
// conectar ao banco de dados.
if (!Ora_Logon($username, $password)) {
error_log("Banco de dados Oracle não disponível!", 0);
}
// Notificar o administrador por e-mail se ficarmos sem FOO
if (!($foo = allocate_new_foo())) {
error_log("Grande problema, estamos sem FOOs!", 1,
"operator@example.com");
}
// Outra forma de chamar error_log():
error_log("Você cometeu um erro!", 3, "/var/tmp/my-errors.log");
?>
error_log() não é seguro para binários. message será truncado pelo caractere nulo.
message não deve conter o caractere nulo. Observe que message pode ser enviado para arquivo, e-mail, syslog, etc. Use a função apropriada de conversão/escape, como base64_encode(), rawurlencode() ou addslashes() antes de chamar error_log().