bibliothèque PHP de journalisation de monologues

Monolog est une bibliothèque de journalisation relativement complète et facilement extensible sous PHP. Actuellement, de nombreux frameworks PHP bien connus, notamment Symfony, Laravel, CakePHP, etc., intègrent Monolog. Monolog peut envoyer vos journaux vers des fichiers, des sockets, des boîtes de réception, des bases de données et divers services Web.

Monolog suit la spécification de l'interface PSR3 et peut être facilement remplacé par d'autres bibliothèques de journalisation qui suivent la même spécification. Monolog a une bonne évolutivité. Grâce aux interfaces Handler, Formatter et Processor, la bibliothèque de classes Monolog peut être étendue et personnalisée de différentes manières.

Utilisation de base

<?php 
use Monolog\Logger; 
use Monolog\Handler\StreamHandler; 
 
// 创建日志频道 
$log = new Logger('name'); 
$log->pushHandler(new StreamHandler('path/to/your.log', Logger::WARNING)); 
 
// 添加日志记录 
$log->addWarning('Foo'); 
$log->addError('Bar');

Concepts de base

Chaque instance de Logger contient un nom de canal (canal) et une pile de gestionnaires. Lorsque vous ajoutez un enregistrement, celui-ci est traité via la pile de gestionnaires. Chaque gestionnaire peut également décider de transmettre ou non l'enregistrement au gestionnaire suivant dans la pile suivante.

Grâce aux gestionnaires, nous pouvons implémenter certaines opérations de journalisation complexes. Par exemple, si nous plaçons StreamHandler au bas de la pile, tous les enregistrements du journal seront finalement écrits dans le fichier du disque dur. Dans le même temps, nous plaçons MailHandler en haut de la pile et envoyons le journal des erreurs par e-mail en définissant le niveau de journalisation. Il existe un attribut $bubble dans Handler. Cet attribut définit si le gestionnaire intercepte les enregistrements et les empêche de passer au gestionnaire suivant. Ainsi, si nous définissons le paramètre $bubble de MailHandler sur false, lorsqu'un journal d'erreurs se produit, le journal sera envoyé via MailHandler au lieu d'être écrit sur le disque dur via StreamHandler.

Plusieurs enregistreurs peuvent être créés, et chacun peut définir son propre nom de canal et sa propre pile de gestionnaires. Les gestionnaires peuvent être partagés entre plusieurs enregistreurs. Le nom du canal sera reflété dans le journal, ce qui nous permettra de visualiser et de filtrer plus facilement les enregistrements du journal.

Si le format du journal (Formatter) n'est pas spécifié, Handler utilisera le Formatter par défaut.

Les niveaux de journalisation ne peuvent pas être personnalisés. Actuellement, les huit niveaux définis dans la RFC 5424 sont utilisés : débogage, information, notification, avertissement, erreur, critique, alerte et urgence. Si vous avez d'autres besoins en matière d'enregistrements de journaux, vous pouvez ajouter du contenu aux enregistrements de journaux via Processo.

Niveau de journalisation

DEBUG (100) : informations de débogage détaillées.

INFO (200) : Événements marquants.

AVIS (250) : Événements ordinaires mais importants.

AVERTISSEMENT (300) : une exception sans erreur s'est produite.

ERROR (400) : erreur d'exécution, mais ne doit pas être traitée immédiatement.

CRITICA (500) : Erreur critique.

URGENCE (600) : Le système est indisponible.