Manuale PHP
Indietro |  | Avanti

# syslog

(PHP 3, PHP 4, PHP 5)

syslog -- Genera un messaggio del system log

## Descrizione

int syslog ( int priorità, string messaggio )

syslog() genera un messaggio di log che viene distribuito dal logger di sistema. priorità è la combinazione della facility e del livello, valori utilizzabili sono riportati nella prossima sezione. L'argomento rimanente è il messaggio da inviare, eccetto i due caratteri %m che vengono sostituiti dalla stringa del messaggio di errore (strerror) corrispondente all'attuale valore di errno.

Tabella 1. Priorità syslog() (in ordine discendente)

Costante | Descrizione
--- | ---
LOG_EMERG | sistema non utilizzabile
LOG_ALERT | azione da intraprendere immediatamente
LOG_CRIT | condizioni critiche
LOG_ERR | condizioni di errore
LOG_WARNING | condizioni di attenzione
LOG_NOTICE | condizione normale, ma significativa
LOG_INFO | messaggio di informazione
LOG_DEBUG | messaggio a livello di debug

Esempio 1. Uso di syslog()

`<?php
define_syslog_variables();
// apre il syslog, include l'ID del processo, invia il
// log anche su standard error e fa uso di un meccanismo
// di logging defiito dall'utente
openlog("IlMioLog", LOG_PID | LOG_PERROR, LOG_LOCAL0);
// un po' di codice
if (client_autorizzato()) {
// fa qualcosa
} else {
// client non autorizzato!
// logga il tentativo
$accesso = date("Y/m/d H:i:s");
syslog(LOG_WARNING,"Client non autorizzato: $accesso $REMOTE_ADDR ($HTTP_USER_AGENT)");
}
closelog();
?>`

Per informazioni su come creare un gestore di log definito dall'utente, fare riferimento alla man page syslog.conf(5) di Unix. Ulteriori informazioni sulle facility di syslog e sulle sue opzioni possono essere trovate sulle macchine Unix nelle man page di syslog(3).

Su Windows NT, il servizio syslog è emulato usando Event Log.

Vedere anche define_syslog_variables(), openlog() e closelog().

Indietro | Partenza | Avanti
socket_set_timeout | Risali | Newt Functions