System-Log: Unterschied zwischen den Versionen

Aktuelle Version vom 4. September 2014, 06:54 Uhr

Funktionen

Der System-Log ist dafür da, Aktionen, die rund um Contao geschehen, zu dokumentieren und registrieren. Er steht auch jedem Entwickler zur Verfügung, der Logs für seine Erweiterungen schreiben möchte (siehe auch die Rubrik Für Entwickler).

Eingefärbt werden die Logeinträge aktuell nach den folgenden Kriterien:

• Konfiguration und Repository: blau

• Cron-Jobs: grün

• Fehler: rot

• Alle anderen Kategorien: schwarz

Für Entwickler

Die Methode System::log() erledigt bequem die Einträge. Da wahrscheinlich jede Klasse mindestens von System erbt, kann man Einträge wie folgt registrieren lassen:

$this->log($strText, $strFunction, $strAction);

• $strText = frei wählbarer Text
• $strFunction = Klasse Methode()
• $strAction = Kategorie

Ein Beispiel für einen Cronjob-Eintrag wäre also zum Beispiel:

$this->log('Running daily cron jobs', 'CronJobs run()', TL_CRON);

Die zur Verfügung stehenden Kategorien findet man übrigens in der system/constants.php (Contao 3: system/config/constants.php). Aktuell gibt es die folgenden:

• TL_ERROR
• TL_ACCESS
• TL_GENERAL
• TL_FILES
• TL_CRON
• TL_FORMS
• TL_CONFIGURATION
• TL_NEWSLETTER
• TL_REPOSITORY