Klassen-Referenz - Logger
Artikel bewerten:
Bitte bewerten Sie den Artikel per Klick auf einen der angezeigten Sterne:
Zurück zum Artikel!
Die Klasse Logger ist ein Tool, mit dem Logging-Aufgaben einfach und zentral
bewerkstelligt werden können. Um die Performance einer Anwendung nicht durch häufige,
verteilte und konkurrierende File-Zugriffe zu beeinträchtigen, sollte der Logger als
Singleton-Instanz erzeugt und verwendet werden. Die Logfile-Einträge werden dann am Ende eines
Requests gesammelt in das entsprechende Logfile geschrieben. Der Logger verwendet
dazu den Registry-Wert LogDir aus dem Namespace apf::core. Dieser
wird mit dem absoluten Pfad zum aktuellen Verzeichnis plus Unterordner
logs initialisiert. Soll ein anderes Log-Verzeichnis verwendet werden, so kann
der Pfad in der Bootstrap-Datei vor dem Erstellen der Page- oder des FrontController per
// Instanz der Registry beziehen
$Reg = &Singleton::getInstance('Registry');
// Log-Verzeichnis anpassen
$Reg->register('apf::core','LogDir','/Pfad/zu/meinem/Log/Verzeichnis');
angepasst werden. Der angegebene Pfad dient der Ablage aller Log-Dateien einer Applikation.
Hinweis: um Fehler beim Zugriff auf das Log-Verzeichnis zu vermeiden, sollte der
Pfad absolut definiert sein!
Zur Verwendung des Loggers muss dieser zunächst per
import('core::logging','Logger');
eingebunden werden. Anschließend kann per
$Log = &Singleton::getInstance('Logger');
eine Referenz auf die Instanz des Loggers im aktuellen Gültigkeitsbereich erzeugt werden. Das
Hinzufügen eines Eintrags mit dem Inhalt MESSAGE zu einem Logfile mit dem Namen
FILENAME ist mit dem Aufruf
$Log->logEntry('FILENAME','MESSAGE');
erledigt. Der dritte Parameter (optional) der Methode logEntry() definiert die
SEVERITY der Meldung und kann frei definiert werden. Für Fehler wird
üblicherweise ERROR eingesetzt, Standard ist INFO.
Kommentare
Möchten Sie den Artikel eine Anmerkung hinzufügen, oder haben Sie ergänzende Hinweise? Dann können Sie diese hier einfügen. Die bereits verfassten Anmerkungen und Kommentare finden Sie in der untenstehenden Liste.
Für diesen Artikel liegen aktuell keine Kommentare vor.
|
