Beschreibung:
int
syslog ( int priority, string message)
Die Funktion syslog() erzeugt eine
Status-Meldung, die an die System-Log-Funktion weitergereicht
wird. Der Parameter priority ist eine
Kombination der System-Möglichkeiten und dem Level. Werte hierzu
werden im nächsten Abschnitt genannt. Es verbleibt die zu
sendende Nachricht, in der die beiden Zeichen
%m durch den Fehlertext (strerror) ersetzt
werden, der dem Wert errno
entspricht.
Tabelle 1.
syslog()-Prioritäten (in absteigender
Reihenfolge)
| Konstante | Beschreibung: |
|---|
| LOG_EMERG | System ist unbrauchbar. |
| LOG_ALERT | Aktion ist sofort erforderlich. |
| LOG_CRIT | Kritischer Zustand. |
| LOG_ERR | Fehler aufgetreten. |
| LOG_WARNING | Warnung aufgetreten. |
| LOG_NOTICE | Normale, aber wichtige, Meldung. |
| LOG_INFO | Informative Meldung. |
| LOG_DEBUG | Debug-Level-Meldung. |
Beispiel 1. Die Verwendung von syslog(): <?php
define_syslog_variables();
// öffne SysLog, schließe die Prozess-ID (PID) ein, sende
// die Log-Meldungen an die Standard-Fehler-Ausgabe und benutze
// einen User-definierten Log-Mechanismus.
openlog("myScripLog", LOG_PID | LOG_PERROR, LOG_LOCAL0);
// etwas Code
if (authorized_client()) {
// mache etwas
} else {
// unerlaubter Client!
// logge den Zugriff
$access = date("Y/m/d H:i:s");
syslog(LOG_WARNING,"Unauthorisierter Client: $access $REMOTE_ADDR ($HTTP_USER_AGENT)");
}
closelog();
?> |
|
Weiter Informationen zum Benutzer-definierten Log-Handler finden
Sie unter
syslog.conf(5) der Unix-Manual-Seiten.
Zusätzliche Informationen zu den SysLog-Möglichkeiten finden Sie
in den Man-Pages zu
syslog(3) (auf UNIX-Systemen).
Unter Windows-NT wird der Syslog-Dienst emuliert, indem der
Ereignis-Protokollierdienst genutzt wird.
Siehe auch define_syslog_variables(),
openlog() und closelog().
