Cookbooks
PHP
Kapitel 5. Gute Programmierpraktiken
Protokollierung

PHP:
Protokollierung

Wie geht das:

PHP verfügt über eine integrierte Fehlerprotokollierungsfunktion, die einfach zu verwenden ist. Fügen Sie einfach error_log() in Ihren Code ein, um eine Nachricht an Ihre Server-Logs zu senden. Sie können es auch so anpassen, dass es in eine bestimmte Datei schreibt.

<?php
// Protokollieren einer einfachen Informationsnachricht
error_log("Dies ist ein Info-Log-Eintrag.");

// Protokollieren einer Fehlermeldung
error_log("Dies ist ein Fehler-Log-Eintrag.", 0);

// Protokollieren in eine angegebene Datei
file_put_contents('/Pfad/zur/deiner/custom.log', "Ein benutzerdefinierter Log-Eintrag.\n", FILE_APPEND);

// Verwendung von Monolog für strukturierte Protokollierung
require 'vendor/autoload.php';
use Monolog\Logger;
use Monolog\Handler\StreamHandler;

// Erstellen des Loggers
$logger = new Logger('name');
// Jetzt einige Handler hinzufügen
$logger->pushHandler(new StreamHandler('/Pfad/zur/deinem/monolog.log', Logger::WARNING));

// Jetzt können Sie Ihren Logger verwenden
$logger->warning('Das ist ein Warn-Log!');
$logger->error('Das ist ein Fehler-Log!');
?>

Dies wird Ihre Protokolle entweder in das Serverprotokoll oder in Ihre angegebene Datei im Klartextformat ausgeben.

Vertiefung:

Früher verließen sich PHP-Entwickler auf die error_log() Funktion oder die Apache/Nginx-Logs, um Probleme zu erfassen, aber das kann chaotisch sein mit der Notwendigkeit, Klartextdateien zu parsen und sie nicht leicht filtern oder sortieren zu können. Hier kommen Protokollierungsbibliotheken wie Monolog ins Spiel, die das Zeitalter des strukturierten Loggings in PHP eingeleitet haben. Diese Lösungen geben Ihnen eine bessere Kontrolle, indem sie mehrere Protokollierungskanäle, Schweregrade und formatierte Ausgaben (wie JSON, was ein Traum für die programmatische Analyse ist) anbieten.

Alternativen zu Monolog umfassen Log4php, KLogger und Apache’s Log4php. In Bezug auf die Implementierung erfordert robustes Logging nicht nur das beliebige Ablegen von Daten, sondern berücksichtigt Dinge wie Protokollrotation, Archivierungsstrategien und die Integration mit Überwachungswerkzeugen, um wirklich nützlich zu sein.

Sie sollten die PSR-3 Logger Interface im Kopf behalten, die eine gemeinsame Schnittstelle für Protokollierungsbibliotheken definiert und die Interoperabilität und eine konsistente Art und Weise, auf Protokollierungsmechanismen zuzugreifen, gewährleistet.

Siehe auch:

Versuchen Sie es zunächst mit den eingebauten Funktionen, aber für einen wartbareren und skalierbareren Ansatz sollten Sie in Erwägung ziehen, sich mit einer Bibliothek wie Monolog vertraut zu machen. Frohes Loggen!

FehlerbehandlungCode in Funktionen organisieren