(PHP 4, PHP 5, PHP 7, PHP 8)
syslog — Gera uma mensagem de registro do sistema
syslog() gera uma mensagem de registro que será distribuída pelo registrador do sistema.
Para obter informações sobre como configurar um manipulador de registros definido pelo usuário, consulte a página de manual do Unix syslog.conf (5). Mais informações sobre os módulos e opções do syslog podem ser encontradas nas páginas man do syslog (3) em máquinas Unix.
priority
priority
é uma combinação do módulo
e do nível. Os valores possíveis são:
Constante | Descrição |
---|---|
LOG_EMERG |
o sistema está inutilizável |
LOG_ALERT |
ações devem ser tomadas imediatamente |
LOG_CRIT |
condições críticas |
LOG_ERR |
condições de erro |
LOG_WARNING |
condições de aviso |
LOG_NOTICE |
condição normal, mas significativa |
LOG_INFO |
mensagem informativa |
LOG_DEBUG |
mensagem em nível de depuração |
message
A mensagem a ser enviada.
Sempre retorna true
.
Exemplo #1 Usando syslog()
<?php
// abre o registrador do sistema, inclui o ID do processo e também envia
// o registro para a saída de erro padrão; e usa um mecanismo de registro
// definido pelo usuário
openlog("meuScriptDeRegistro", LOG_PID | LOG_PERROR, LOG_LOCAL0);
// algum código
if (authorized_client()) {
// faz alguma coisa
} else {
// cliente não autorizado!
// registra a tentativa
$access = date("d/m/Y H:i:s");
syslog(LOG_WARNING, "Cliente não autorizado: $access {$_SERVER['REMOTE_ADDR']} ({$_SERVER['HTTP_USER_AGENT']})");
}
closelog();
?>
No Windows, o serviço de registrador do sistema é emulado pelo Log de Eventos.
Nota:
O uso das constantes
LOG_LOCAL0
atéLOG_LOCAL7
para o parâmetrofacility
da função openlog() não está disponível no Windows.