jeudi 18 décembre 2014

PHP / Logging : indispensable !


Tout développeur qui se respecte doit à un moment donné logger des informations que cela soit dans un but informatif ou de "debug".

Ces informations loggées sont redirigées vers la sortie standard par exemple ou vers un fichier (nous parlons dans ce cas de fichier LOG).

Dans un contexte WEB où tester un site / application est assez difficile, le fichier LOG prend alors une autre dimension.

Il devient un outil complémentaire très intéressant et surtout très utile pour tester vos applications.

Il existe de nombreuses API de type LOG : nous allons nous intéresser à l'une d'entre elles.

Son intégration dans une application est très simple : c'est une unique classe PHP (Logger.class.php).

A noter que cette classe fonctionne uniquement en PHP 5.

Vous trouverez ci-joint le source ainsi que de nombreux exemples d'utilisation de cette classe.

En résumé :

$logger = new Logger('./log');

Nous instancions la classe.

Au préalable, il faut créer un répertoire (par exemple /log) qui contiendra vos fichiers LOG.

$logger->log('mon_repertoire', "mon_fichier_log", $information, Logger::GRAN_MONTH);

<mon_repertoire> = répertoire "parent" qui va contenir votre fichier LOG

<mon_fichier_log> = votre fichier log formaté d'une certaine façon

Exemple de fichier LOG :

02/12/2014 10:21:38 mon information...

<$information> = String PHP qui contient l'information à logger

<GRAN_MONTH> = niveau de granularité que vous souhaitez - dans cet exemple regroupement par mois (création d'un sous - répertoire "mois" dans le répertoire "parent", lequel contiendra votre fichier LOG)

Nous avons donc une API simple, assez paramétrable qui vous rendre bien des services.

Aucun commentaire:

Enregistrer un commentaire