Objectif
Lors du développement d’un module ou pour en faciliter la maintenance, il est intéressant de pouvoir journaliser (ou logger) des informations.
Exemple
Définir le répertoire de logs
Par défaut, le répertoire est dans « /installation-de-joomla/logs », commençons par vérifier que ce répertoire est bien défini dans le fichier « configuration.php » :
class JConfig { // ... var $log_path = '/installation-de-joomla/logs';
Journaliser un message
Ajouter cette portion de code dans un contrôleur, un modèle, une vue, etc :
jimport( 'joomla.error.log' ); // créer un objet journaliseur $logger = JLog::getInstance("mon-fichier-de-log.php"); // écrire un message $logger->addEntry(array('comment'=>'tout se passe bien !'));
Consulter le fichier de log
nico@laptop:/var/www/joomla/logs$ more mon-fichier-de-log.php
#<?php die('Direct Access To Log Files Not Permitted'); ?>
#Version: 1.0
#Date: 2009-06-06 10:08:18
#Fields: date time level c-ip status comment
#Software: Joomla! 1.5.9 Production/Stable [ Vatani ] 9-January-2009 23:00 GMT
2009-06-06 10:08:18 - 127.0.0.1 - tout se passe bien !Conclusion
Pour aller plus loin vous pouvez vous reporter à la page de l’API Joomla!, bon log et à bientôt !