Türchen 18: Mage::Log – Logging in Magento

Türchen 18 schreibt alles mit. Es ist ein Log-Türchen. So ist es in Magento relativ einfach möglich mittels der Methode Mage::Log Einträge in die Magento eigene Log-Datei zu schreiben.

Dabei ist der erste Schritt das aktivieren der Log-Dateien selbst. Dazu einfach unter System/ Configuration/ Developer/ Log Enabled auf Yes setzen.

Nun schreiben alle Module, die noch Debug-Ausgaben besitzen, diese nach var/log. Ausnahmen, also Exceptions, werden bei in der exception.log gespeichert, reine Informationen (Strings) in der system.log. Unterschieden wird dies manuell durch den Aufruf von Mage::Log bzw. Mage::logException

Somit führt

Mage::Log("Hallo Welt");

zu einem Eintrag im system.log und

try {
  throw new Exception("Ein Ausnahmefehler");
} catch( Exception $e ) {
  Mage::logException($e);
}

zu einem Eintrag in der exception.log.

Mage::Log bietet dabei noch die Möglichkeit anzugeben in welche Datei das Logging erfolgen soll und ob das Logging, unabhängig von den Einstellungen im Admin, stattfindet:

     /**
     * log facility
     *
     * @param string $message
     * @param integer $level
     * @param string $file
     * @param bool $forceLog
     */
    public static function log($message, $level = null, $file = '', $forceLog = false)