Journalisation pour PHP : meilleures solutions et bibliothèques pour un site

Journalisation pour PHP : meilleures solutions et outils

La journalisation est l'une des tâches clés lors du développement de toute application web en PHP. Sans une journalisation de qualité, il est impossible de déboguer efficacement le code, de suivre les erreurs en production et d'analyser le comportement des utilisateurs. Dans cet article, nous examinerons les meilleures bibliothèques et outils de journalisation en PHP, leurs caractéristiques et des exemples d'utilisation.

Pourquoi est-il important de bien journaliser ?

Un simple appel à error_log() ou une écriture dans un fichier via file_put_contents() n'est plus suffisant lorsque le projet prend de l'ampleur. Les solutions modernes offrent :

• La prise en charge de PSR-3 (norme d'interface de journalisation) ;
• Des gestionnaires flexibles (fichiers, BDD, syslog, email, Slack) ;
• Le formatage des messages (JSON, texte brut, HTML) ;
• Les niveaux de journalisation (debug, info, notice, warning, error, critical, alert, emergency) ;
• La possibilité de filtrer et de faire la rotation des journaux.

1. Monolog — le standard de facto

Monolog est la bibliothèque de journalisation la plus populaire en PHP (plus de 300 millions de téléchargements sur Packagist). Elle est entièrement conforme à PSR-3 et prend en charge des dizaines de gestionnaires (handlers) et de formateurs.

Installation

composer require monolog/monolog

Exemple d'utilisation

<?phprequire 'vendor/autoload.php';

use Monolog\\Logger;use Monolog\\Handler\\StreamHandler;use Monolog\\Handler\\FirePHPHandler;

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

// Journalisation des messages$log->warning('Attention : limite de requêtes dépassée');$log->error('Erreur de connexion à la BDD', ['db' => 'mysql', 'time' => 1.5]);?>

Fonctionnalités clés

• Handlers : StreamHandler, RotatingFileHandler, SyslogHandler, SwiftMailerHandler, SlackHandler, etc.
• Formatters : LineFormatter, JsonFormatter, HtmlFormatter, LogstashFormatter.
• Processors : ajout de contexte (IP, URI, session) à chaque message.
• Prise en charge des groupes de loggers et des canaux.

Monolog est idéal pour les grands projets, les frameworks (Symfony, Laravel l'utilisent par défaut) et l'architecture microservices.

2. KLogger — une alternative légère

KLogger est une bibliothèque simple mais efficace pour ceux qui n'ont pas besoin de centaines de gestionnaires. Elle implémente PSR-3 et fonctionne "prête à l'emploi".

Installation

composer require katzgrau/klogger

Exemple d'utilisation

<?phprequire 'vendor/autoload.php';

use Katzgrau\\KLogger\\Logger;

$log = new Logger(__DIR__.'/logs');$log->info('Utilisateur enregistré', ['user_id' => 42]);$log->debug('Débogage : requête vers l\\'API', ['url' => '/api/v1/data']);?>

Caractéristiques

• Rotation automatique des journaux par date ;
• Nombre minimal de dépendances ;
• Prise en charge des niveaux de journalisation ;
• API simple (seulement quelques méthodes).

KLogger convient aux petits projets, scripts et applications où la simplicité est importante.

3. Analog — flexible et minimaliste

Analog est une bibliothèque qui permet de changer facilement la méthode de journalisation sans modifier le code. Elle utilise le concept de "machine" qui détermine où et comment écrire les journaux.

Installation

composer require analog/analog

Exemple d'utilisation

<?phprequire 'vendor/autoload.php';

use Analog\\Analog;use Analog\\Handler\\File;

// Configuration de l'écriture dans un fichierAnalog::handler(File::init(__DIR__.'/app.log'));

// JournalisationAnalog::warning('Mise à jour nécessaire