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:
$logger = Zend_Log::factory(array(
array(
'writerName' => 'Stream',
'writerParams' => array(
'stream' => '/tmp/zend.log',
),
'filterName' => 'Priority',
'filterParams' => array(
'priority' => Zend_Log::WARN,
),
),
array(
'writerName' => 'Firebug',
'filterName' => 'Priority',
'filterParams' => array(
'priority' => Zend_Log::INFO,
),
),
));
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.
- 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.
Dieser Log Writer nimmt keine Optionen; alle übergebenen werden ignoriert.
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.
Dieser Log Writer nimmt keine Optionen; alle übergebenen werden ignoriert.
Dieser Log Writer nimmt keine Optionen; alle übergebenen werden ignoriert.
- 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".
- application
-
Der Name der Anwendung die vom Syslog Writer verwendet wird.
- facility
-
Die Facility die vom Syslog Writer verwendet wird.
- regexp
-
Ein regulärer Ausdruck der passen muss damit eine Nachricht geloggt wird.
- 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 "<=".
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:
class My_Log_Writer_Foo extends Zend_Log_Writer_Abstract
{
public function __construct($bar, $baz)
{
// ...
}
public static function factory($config)
{
if ($config instanceof Zend_Config) {
$config = $config->toArray();
}
if (!is_array($config)) {
throw new Exception(
'factory erwartet ein Array oder eine Instanz von Zend_Config'
);
}
$default = array(
'bar' => null,
'baz' => null,
);
$config = array_merge($default, $config);
return new self(
$config['bar'],
$config['baz']
);
}
}
Alternativ könnte man die richtigen Setter nach der Instanzierung aufrufen, aber noch bevor die Instanz zurückgegeben wird:
class My_Log_Writer_Foo extends Zend_Log_Writer_Abstract
{
public function __construct($bar = null, $baz = null)
{
// ...
}
public function setBar($value)
{
// ...
}
public function setBaz($value)
{
// ...
}
public static function factory($config)
{
if ($config instanceof Zend_Config) {
$config = $config->toArray();
}
if (!is_array($config)) {
throw new Exception(
'factory erwartet ein Array oder eine Instanz von Zend_Config'
);
}
$writer = new self();
if (isset($config['bar'])) {
$writer->setBar($config['bar']);
}
if (isset($config['baz'])) {
$writer->setBaz($config['baz']);
}
return $writer;
}
}