Journalisation pour PHP : meilleures solutions et bibliothèques

Journalisation pour PHP : meilleures solutions et bibliothèques

La journalisation est l'un des aspects clés du développement de toute application web. Sans une journalisation de qualité, il est impossible de déboguer efficacement les erreurs, de suivre le comportement des utilisateurs ou d'analyser les performances du système. Dans l'écosystème PHP, il existe plusieurs solutions matures qui méritent l'attention. Dans cet article, nous examinerons les meilleures bibliothèques de journalisation, leurs caractéristiques et des exemples d'utilisation.

Pourquoi la journalisation en PHP ?

La journalisation permet aux développeurs :

• d'enregistrer les erreurs critiques et les exceptions ;
• de suivre la séquence des actions de l'utilisateur ;
• d'analyser les performances et les goulots d'étranglement ;
• de collecter des données pour l'audit de sécurité ;
• de s'intégrer avec des systèmes de surveillance externes (Graylog, ELK, Sentry).

La norme PSR-3 (PHP Standards Recommendation) définit une interface unifiée pour les loggers, rendant les bibliothèques interchangeables.

1. Monolog — le standard de facto

Monolog est la bibliothèque de journalisation la plus populaire en PHP. Elle est entièrement conforme à PSR-3 et prend en charge des dizaines de gestionnaires (handlers) et de formateurs.

Fonctionnalités principales :

• Envoi des logs vers des fichiers, bases de données, syslog, Slack, Telegram, email ;
• Prise en charge de la rotation des fichiers et de la compression ;
• Configuration flexible des niveaux de journalisation (debug, info, notice, warning, error, critical, alert, emergency) ;
• Processeurs pour ajouter des informations contextuelles (IP, User-Agent, temps d'exécution).

Exemple d'installation et d'utilisation :

composer require monolog/monolog

<?phpuse Monolog\\Logger;use Monolog\\Handler\\StreamHandler;use Monolog\\Handler\\FirePHPHandler;

// Création du logger$log = new Logger('my_app');// Ajout des gestionnaires$log->pushHandler(new StreamHandler(__DIR__ . '/app.log', Logger::WARNING));$log->pushHandler(new FirePHPHandler());

// Utilisation$log->warning('Avertissement : dépassement de la limite de requêtes', ['ip' => '192.168.1.1']);$log->error('Erreur de base de données', ['query' => 'SELECT * FROM users']);?>

Monolog s'intègre facilement avec les frameworks (Laravel, Symfony) et peut être utilisé comme bibliothèque autonome.

2. Log4php — portage d'une solution Java populaire

Log4php est l'adaptation de la célèbre bibliothèque Java Log4j pour PHP. Elle prend en charge les loggers hiérarchiques, divers appenders et layouts.

Caractéristiques clés :

• Configuration via XML ou fichiers de propriétés (properties) ;
• Prise en charge du filtrage par niveaux et catégories ;
• Appenders intégrés : fichier, base de données, syslog, console ;
• Possibilité de créer ses propres appenders.

Exemple de configuration et d'utilisation :

<?phprequire_once 'log4php/Logger.php';Logger::configure('config.xml');

$logger = Logger::getLogger('main');$logger->info('Application démarrée');$logger->error('Impossible de se connecter à la base de données');?>

<!-- config.xml --><configuration xmlns="http://logging.apache.org/log4php/">    <appender name="default" class="LoggerAppenderFile">        <param name="file" value="logs/app.log" />    </appender>    <root>        <level value="DEBUG" />        <appender_ref ref="default" />    </root></configuration>

Log4php convient bien aux projets migrant de Java, ou à ceux qui apprécient une hiérarchie stricte des loggers.

3. KLogger — simplicité et minimalisme

KLogger est une bibliothèque légère qui ne nécessite aucune dépendance externe. Idéale pour les petits projets ou les scripts.

Caracté