La PSR-3, ou Logger Interface, est une spécification standardisée en PHP qui définit une interface commune pour les bibliothèques de journalisation. Son objectif principal est de permettre aux développeurs de rendre leur code portable et réutilisable, quel que soit le système de journalisation sous-jacent utilisé.
Niveaux de journalisation : La PSR-3 définit huit niveaux de journalisation, classés par ordre de gravité croissante :
- debug() : Informations utiles pour le débogage du code.
- info() : Informations générales.
- notice() : Événements normaux mais significatifs.
- warning() : Événements qui ne sont pas des erreurs, mais qui peuvent indiquer un problème potentiel.
- error() : Erreurs d'exécution qui ne nécessitent pas une intervention immédiate.
- critical() : Conditions critiques qui nécessitent une attention immédiate.
- alert() : Mesures à prendre immédiatement.
- emergency() : Le système est inutilisable.
use Psr\Log\LoggerInterface;
use Psr\Log\LogLevel;
class MyClass
{
private $logger;
public function __construct(LoggerInterface $logger)
{
$this->logger = $logger;
}
public function doSomething($data)
{
$this->logger->debug('Début de la méthode doSomething', ['data' => $data]);
// ... faire quelque chose ...
$this->logger->info('Méthode doSomething terminée');
if ($data['error']) {
$this->logger->error('Une erreur s\'est produite', ['error_code' => 500]);
// ... gérer l'erreur ...
}
}
}