openlog

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

    openlog — Stellt eine Verbindung zum Log-Dienst des Systems her

    Beschreibung

    openlog(string$prefix, int$flags, int$facility): bool

    Die Funktion openlog() öffnet eine Verbindung zum System-Log-Dienst eines Programmes.

    Die Verwendung von openlog() ist optional. Die Funktion wird - falls erforderlich - automatisch von syslog() aufgerufen, dabei wird prefix standardmäßig mit false belegt.

    Parameter-Liste

    prefix

    Die Zeichenkette prefix wird jeder Meldung hinzugefügt.

    flags

    Der Parameter flags wird verwendet, um anzuzeigen, welche Logging-Optionen bei der Generierung einer Log-Meldung verwendet wurden.

    openlog()-Optionen
    KonstanteBeschreibung
    LOG_CONS Tritt ein Fehler auf, während Daten an den Systemlogger gesendet werden, leite die Ausgabe direkt an die Konsole um.
    LOG_NDELAY Öffnet die Verbindung zum Log-Dienst sofort.
    LOG_ODELAY (Standardwert); öffnet die Verbindung erst, wenn die erste Meldung geloggt werden soll.
    LOG_PERROR Schreibt den Log-Eintrag auch in das Standard-Error-Device
    LOG_PIDFügt die PID an jede Meldung an
    Sie können eine oder mehrere dieser Optionen verwenden. Benutzen Sie mehrere, müssen diese per OR getrennt werden. Um zum Beispiel die Verbindung sofort herzustellen, auf die Konsole zu schreiben und zugleich die PID in jede Meldung aufzunehmen, müssen Sie folgendes angeben: LOG_CONS | LOG_NDELAY | LOG_PID.
    facility

    Das Argument facility wird verwendet, um die Art des Programmes festzulegen, das die Nachricht loggt. Dies erlaubt Ihnen (in Ihrer speziellen SysLog-Konfiguration) die Festlegung der Behandlungsweise von Log-Meldungen.

    openlog()-Möglichkeiten
    KonstanteBeschreibung
    LOG_AUTH Sicherheits-/Authorisierungsmeldungen (benutzt statt dessen LOG_AUTHPRIV auf Systemen, wo diese Konstante definiert ist).
    LOG_AUTHPRIVSicherheits-/Authorisierungsmeldungen (private).
    LOG_CRONZeitabhängig gestartete Dienste (cron und at).
    LOG_DAEMONAndere Systemdienste.
    LOG_KERNKernel-Meldungen
    LOG_LOCAL0 ... LOG_LOCAL7 Reserviert für lokale Benutzung. Diese Konstanten stehen unter Windows nicht zur Verfügung.
    LOG_LPRZeilendrucker-Subsystem.
    LOG_MAILMailing-Subsystem.
    LOG_NEWSUSENET-News-Subsystem.
    LOG_SYSLOGMeldungen die intern von syslogd erzeugt wurden.
    LOG_USERGenerische User-Level-Meldungen.
    LOG_UUCPUUCP-Subsystem

    Hinweis:

    LOG_USER ist der einzige unter Windows-Betriebssystemen gültige Logtyp.

    Rückgabewerte

    Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.

    Siehe auch

    • syslog() - Erzeugt eine Meldung für das System-Log
    • closelog() - Schließt die Verbindung zum System-Logger
    To Top