Gera uma mensagem de registro do sistema

Descrição

syslog(int $priority, string $message): true

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.

Parâmetros

priority

priority é uma combinação do módulo e do nível. Os valores possíveis são:

**Prioridades de **syslog()** (em ordem decrescente)**
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.

Valor Retornado

Sempre retorna true.

Exemplos

Example #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();
?>

Notas

No Windows, o serviço de registrador do sistema é emulado pelo Log de Eventos.

Note:
O uso das constantes LOG_LOCAL0 até LOG_LOCAL7 para o parâmetro facility da função openlog() não está disponível no Windows.

Veja Também

openlog() - Abre conexão com o registrador do sistema
closelog() - Fecha conexão com o registrador do sistema
Configuração INI syslog.filter (a partir do PHP 7.3)