array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.syslog.php', 1 => 'syslog', 2 => 'Gera uma mensagem de registro do sistema', ), 'up' => array ( 0 => 'ref.network.php', 1 => 'Funções de Network', ), 'prev' => array ( 0 => 'function.socket-set-timeout.php', 1 => 'socket_set_timeout', ), 'next' => array ( 0 => 'book.rrd.php', 1 => 'RRD', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/network/functions/syslog.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

syslog

(PHP 4, PHP 5, PHP 7, PHP 8)

syslog — 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

Uma das constantes: LOG_EMERG, LOG_ALERT, LOG_CRIT, LOG_ERR, LOG_WARNING, LOG_NOTICE, LOG_INFO, LOG_DEBUG .

message

A mensagem a ser enviada.

Valor Retornado

Sempre retorna true.

Exemplos

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

Notas

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âmetro facility da função openlog() não está disponível no Windows.

Veja Também