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: '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. 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: 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: 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; } } ]]>