array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'it', ), 'this' => array ( 0 => 'function.syslog.php', 1 => 'syslog', 2 => 'Genera un messaggio del system log', ), 'up' => array ( 0 => 'ref.network.php', 1 => 'Network Funzioni', ), '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' => 'it', '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 — Genera un messaggio del system log

Descrizione

syslog(int $priorità, string $messaggio): int

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.

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

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