openlog
(PHP 4, PHP 5, PHP 7, PHP 8)
openlog — Abre conexão com o registrador do sistema
Descrição
openlog() abre uma conexão com o registrador do sistema para um programa.
O uso de openlog() é opcional. Ela
será automaticamente chamada por syslog() se
necessário, e nesse caso prefix
será padronizado
como false
.
Parâmetros
prefix
-
O parâmetro
prefix
define uma string de prefixo que é adicionado a cada mensagem. flags
-
O argumento
flags
é usado para indicar quais opções de registro serão usadas ao gerar uma mensagem de registro.Opções de openlog() Constante Descrição LOG_CONS
se houver um erro ao enviar dados para o registrador do sistema, grava diretamente no console do sistema LOG_NDELAY
abre a conexão com o registrador imediatamente LOG_ODELAY
(padrão) retarda a abertura da conexão até que a primeira mensagem seja registrada LOG_PERROR
exibe mensagem de registro também na saída de erro padrão LOG_PID
inclui PID em cada mensagem OR
, ou seja, para abrir a conexão imediatamente, escrever no console e incluir o PID em cada mensagem, deve-se usar:LOG_CONS | LOG_NDELAY | LOG_PID
facility
-
O argumento
facility
é usado para especificar que tipo de programa está registrando a mensagem. Isto permite que seja especificado (na configuração do syslog da máquina) como as mensagens provenientes de diferentes módulos serão tratadas.Módulos de openlog() Constante Descrição LOG_AUTH
mensagens de segurança/autorização (consulte LOG_AUTHPRIV
em sistemas onde esta constante estiver definida)LOG_AUTHPRIV
mensagens de segurança/autorização (privadas) LOG_CRON
daemons de relógio ('cron' e 'at') LOG_DAEMON
outros daemons de sistema LOG_KERN
mensagens do kernel LOG_LOCAL0
...LOG_LOCAL7
reservadas para uso local, não disponíveis no Windows LOG_LPR
subsistema de impressora de linha LOG_MAIL
subsistemas de e-mail LOG_NEWS
subsistema de notícias USENET LOG_SYSLOG
mensagens geradas internamente pelo syslogd LOG_USER
mensagens genéricas no nível do usuário LOG_UUCP
subsistema UUCP Note:
LOG_USER
é o único tipo de registro válido nos sistemas operacionais Windows.
Valor Retornado
Sempre retorna true
.
Registro de Alterações
Versão | Descrição |
---|---|
8.2.0 |
A função agora sempre retorna true . Anteriormente, retornava false em caso de falha.
|
Veja Também
- syslog() - Gera uma mensagem de registro do sistema
- closelog() - Fecha conexão com o registrador do sistema