Des logs qui marchent tout de suite : Monolog
Quand un script Ă©choue hors du navigateur, sans personne pour le regarder, une ligne de log est la seule trace quâil laisse. Monolog est le logger que presque tous les frameworks PHP enveloppent : la façade Log de Laravel et le service logger de Symfony sont lâun comme lâautre Monolog avec une façade plus aimable. Utilisez-le directement et chaque projet, avec ou sans framework, se retrouve avec des logs de la mĂȘme forme.
composer require monolog/monolog
<?php
require 'vendor/autoload.php';
use Monolog\Level;
use Monolog\Logger;
use Monolog\Handler\StreamHandler;
use Monolog\Handler\RotatingFileHandler;
$log = new Logger('import-job');
$log->pushHandler(new StreamHandler('php://stdout', Level::Info));
$log->pushHandler(new RotatingFileHandler(__DIR__ . '/logs/import.log', 14, Level::Debug));
$log->info('Import started', ['file' => 'users.csv']);
try {
// ... do the work ...
} catch (\Throwable $e) {
$log->error('Import failed', ['exception' => $e]);
}
Un seul logger Ă©crit Ă plusieurs endroits Ă la fois : la console, un fichier avec rotation, un service comme Sentry (voir Attraper lâerreur en production). Chaque destination est un handler de plus.
Quand le choisir
Tout script ou service qui tourne hors dâun cycle requĂȘte-rĂ©ponse : un worker de file dâattente, une tĂąche cron, un import en ligne de commande. Si personne ne fixe le terminal quand il Ă©choue, il lui faut un log.
Quand ce nâest pas le bon outil
Dans Laravel ou Symfony, utilisez la façade Log ou le service logger du framework. Câest Monolog dessous, dĂ©jĂ configurĂ© avec des handlers raisonnables, et cohĂ©rent avec la façon dont le reste de lâapplication journalise.
Sous le capot : Monolog implĂ©mente PSR-3, lâinterface de journalisation standard quâattendent la plupart des frameworks et bibliothĂšques PHP. Câest pour cela quâune bibliothĂšque installĂ©e par
composer requirepeut accepter « un logger » dans son constructeur sans se soucier de recevoir Monolog lui-mĂȘme ou lâenveloppe dâun framework autour.