Die Factory verwenden um ein Log zu erstellen
Zusätzlich zur direkten Instanzierung kann man auch die statische
factory() Methode verwenden um eine Log Instanz zu initiieren,
und auch um angehängte Writer und deren Filter zu konfigurieren. Bei Verwendung der
Factory kann man keine oder mehrere Writer anhängen. Die Konfiguration kann entweder als
Array oder Instanz von Zend_Config übergeben werden.
Als Beispiel:
span style="color: #ff0000;">'writerName' => 'Stream',
'writerParams''stream' => '/tmp/zend.log',
),
'filterName' => 'Priority',
'filterParams''priority''writerName' => 'Firebug',
'filterName' => 'Priority',
'filterParams''priority'
Das obige instanziert einen Logger mit zwei Writern, einen für das schreiben einer lokalen
Daten, und einen anderen für das Senden der Daten zu Firebug. Jeder hat einen angehängten
Filter für Prioritäten, mit unterschiedlichen maximalen Prioritäten.
Jeder Writer kann mit den folgenden Schlüsseln definiert werden:
-
- writerName (required)
-
Der "kurze" Name eines Log Writers; der Name des Log Writers ohne den führenden
Klassenpräfix/Namespace. Siehe auch den "writerNamespace" Eintrag weiter unten
für weitere Details. Beispiele: "Mock", "Stream", "Firebug".
-
- writerParams (optional)
-
Ein assoziatives Array von Parametern das verwendet wird wenn der Log Writer
instanziert wird. Jede factory() Methode eines Log
Writers führt diese mit den Argumenten des Contructors zusammen, wie anbei
erwähnt.
-
- writerNamespace (optional)
-
Der Klassenpräfix/Namespace der verwendet wird wenn der endgültige Klassenname
des Log Writers erstellt wird. Wird er nicht angegeben, dann wird standardmäßig
"Zend_Log_Writer" angenommen; trotzdem kann man einen eigenen Namespace
übergeben, wenn man einen eigenen Log Writer verwendet.
-
- filterName (optional)
-
Der "kurze" Name des Filters der mit dem angegebenen Log Writer verwendet werden
soll; der Name des Filters ohne den führenden Klassenpräfix/Namespace. Siehe
auch den "filterNamespace" Eintrag weiter unter für weitere Details. Beispiele:
"Message", "Priority".
-
- filterParams (optional)
-
Ein assoziatives Array an Parametern das verwendet wird wenn der Log Filter
instanziert wird. Jede factory() Methode eines Log
Filters führt diese mit den Constructor Argumenten zusammen, wie anbei erwähnt.
-
- filterNamespace (optional)
-
Der Klassenpräfix/Namespace der verwendet wird wenn der endgültige Klassenname
des Log Filters erstellt wird. Wird er nicht angegeben, dann wird standardmäßig
"Zend_Log_Filter" angenommen; trotzdem kann man einen eigenen Namespace
übergeben, wenn man einen eigenen Log Filter verwendet.
Jeder Writer und jeder Filter hat spezifische Optionen.
Writer Optionen
Zend_Log_Writer_Db Optionen
-
- db
-
Eine Instanz von Zend_Db_Adapter.
-
- table
-
Der Name der Tabelle in der RDBMS welche Log Einträge enthalten soll.
-
- columnMap
-
Ein assoziatives Array welches die Namen der Spalten der
Datenbanktabelle mit den Feldern der Log Events verknüpft.
Zend_Log_Writer_Firebug Optionen
Dieser Log Writer nimmt keine Optionen; alle übergebenen werden ignoriert.
Zend_Log_Writer_Mail Optionen
Zend_Log_Writer_Mail implementiert aktuell (mit 1.10) keine
Factory, und wirft eine Exception wenn man versucht Ihn über
Zend_Log::factory() zu instanzieren.
Zend_Log_Writer_Mock Optionen
Dieser Log Writer nimmt keine Optionen; alle übergebenen werden ignoriert.
Zend_Log_Writer_Null Optionen
Dieser Log Writer nimmt keine Optionen; alle übergebenen werden ignoriert.
Zend_Log_Writer_Stream Optionen
-
- stream|url
-
Ein gültiger Identifikator eines PHP Streams auf den
geloggt werden soll.
-
- mode
-
Der I/O Modus mit dem geloggt werden soll; Standardwert ist "a" für
"append".
Zend_Log_Writer_Syslog Optionen
-
- application
-
Der Name der Anwendung die vom Syslog Writer verwendet wird.
-
- facility
-
Die Facility die vom Syslog Writer verwendet wird.
Zend_Log_Writer_ZendMonitor Optionen
Dieser Log Writer nimmt keine Optionen; alle übergebenen werden ignoriert.
Filter Optionen
Zend_Log_Filter_Message Optionen
-
- regexp
-
Ein regulärer Ausdruck der passen muss damit eine Nachricht geloggt
wird.
Zend_Log_Filter_Priority Optionen
-
- priority
-
Das maximale Level der Priorität mit dem Nachrichten geloggt werden.
-
- operator
-
Der Vergleichsoperator mit dem Vergleiche der Priorität durchgeführt
werden; der Standardwert ist "<=".
Zend_Log_Writer_Suppress Optionen
Dieser Log Filter nimmt keine Optionen; alle übergebenen werden ignoriert.
Erstellen konfigurierbarer Writer und Filter
Wenn man die Notwendigkeit hat eigene Log Writer und/oder Filter zu schreiben kann man
diese sehr einfach zu Zend_Log::factory() kompatibel machen.
Dazu muss man mindestens Zend_Log_FactoryInterface
implementieren, welches eine statische factory() Methode
erwartet die ein einzelnes $config Argument akzeptiert. Wenn der
eigene Log Writer Zend_Log_Writer_Abstract erweitert, oder der
eigene Filter Zend_Log_Filter_Abstract erweitert, nimmt man das
bereits kostenlos mit.
Dann muss man einfach Verknüpfungen zwischen akzeptierten Konfigurationen und den
Contructor Argumenten definieren. Als Beispiel:
span style="color: #808080; font-style: italic;">// ...
'factory erwartet ein Array oder eine Instanz von Zend_Config''bar''baz''bar'],
$config['baz']
);
}
}
Alternativ könnte man die richtigen Setter nach der Instanzierung aufrufen, aber noch
bevor die Instanz zurückgegeben wird:
span style="color: #808080; font-style: italic;">// ...
// ...
// ...
'factory erwartet ein Array oder eine Instanz von Zend_Config''bar'])) {
$writer->setBar($config['bar''baz'])) {
$writer->setBaz($config['baz'
|
|