jLog est une classe qui permet de tracer, ou plus précisément d'écrire des messages ou le contenu de variable dans un fichier journal. Elle possède pour cela deux méthodes statiques :

• jLog::log($message) pour écrire un message dans le fichier journal
• jLog::dump($variable, $message) pour écrire le contenu de la variable dans le fichier journal (il s'agit en fait d'un var_export)

Le fichier journal par défaut est var/log/messages.log dans votre application.

Vous pouvez avoir plusieurs fichiers journaux. Pour cela, dans la configuration, vous indiquez ces fichiers dans la section logfile :

[logfiles]
default = messages.log
news = modulenews.log

Vous pouvez alors indiquer le code du fichier journal à utiliser, en paramètre supplémentaire aux méthodes log et dump :

 jLog::log("hello !", "news");
 jLog::dump($record, "enregistrement news", "news");

Enfin, il arrive que plusieurs développeurs travaillent sur un même serveur : il y aurait alors dans un même fichier toutes les traces que chacun aurait mises. Il est possible d'avoir autant de fichiers journaux que de développeurs, à condition qu'ils aient une adresse IP différente. Il suffit d'inclure "%ip%" dans le nom du fichier :

[logfiles]
default = "messages_%ip%.log"
news = "%ip%_modulenews.log"

Ainsi, si un développeur a son poste de travail en 192.168.1.2, alors il y aura des fichiers 192.168.1.2_modulenews.log et messages_192.168.1.2.log

Vous pouvez aussi construire les noms des fichiers de log avec la date et l'heure : pour cela, incluez un ou plusieurs des "tags" suivant dans le nom : %Y% (année), %m% (mois), %d% (jour), %H% (heure).

Si vous voulez afficher les messages de log dans la réponse, ou dans Firebug (une extension pour Firefox), indiquez respectivement "!response" et "!firebug" comme nom de fichier :

[logfiles]
default = "!response"
news = "!firebug"