PSR 03 - Logger Interface

Ce document décrit une interface commune pour la journalisation des bibliothèques.

L'objectif principal est de permettre aux bibliothèques de recevoir un objet Psr\Log\LoggerInterface et d'y écrire des logs de manière simple et universelle.

Les frameworks et les CMS qui ont des besoins personnalisés peuvent étendre l'interface pour leur propre usage, mais doivent rester compatibles avec ce document. Cela garantit que les bibliothèques tierces qu'une application utilise peuvent écrire dans les journaux d'application centralisés.

Caractéristiques

Notion de base

• Le LoggerInterface propose huit méthodes pour écrire des rapports aux huit niveaux de la RFC 5424 (debug, info, notice, warning, error, critical, alert, emergency).
• Une neuvième méthode, le log, accepte un niveau de log comme premier argument. L'appel de cette méthode avec une des constantes de niveau log DOIT avoir le même résultat que l'appel de la méthode spécifique au niveau. L'appel de cette méthode avec un niveau non défini par cette spécification DOIT lancer un Psr\Log\InvalidArgumentException si l'implémentation ne connaît pas le niveau. Les utilisateurs NE DOIVENT PAS utiliser un niveau spécifique sans être sûrs que l'implémentation actuelle le supporte.

Message