array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.error-log.php', 1 => 'error_log', ), 'up' => array ( 0 => 'ref.errorfunc.php', 1 => 'Funções para Manuseamento de Erros', ), 'prev' => array ( 0 => 'function.error-get-last.php', 1 => 'error_get_last', ), 'next' => array ( 0 => 'function.error-reporting.php', 1 => 'error_reporting', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/errorfunc/functions/error-log.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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
= null
Envia uma mensagem de erro para o registro de erros do servidor web ou para um arquivo.
message
A mensagem de erro que deve ser registrada.
message_type
Indica 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().