Subversion Repositories Applications.framework

<?php
//declare(encoding='UTF-8');
/**
 * Classe permettant de logger des messages dans les fichier situés dans le dossier de log.
 *
 * @category    PHP 5.2
 * @package             Framework
 * @author              aurelien <aurelien@tela-botanica.org>
 * @copyright   2009 Tela-Botanica
 * @license     http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
 * @version   SVN: $Id: Log.php 255 2010-12-23 10:37:30Z jpm $
 * @link          /doc/framework/
 */

class Log {

        /**
         * Boolean indiquant si l'on doit utiliser les logs ou pas
         */
        private static $logger = false;

        /**
         * Tableau associatif stockant les descripteurs de fichiers
         */
        private static $fichiersLog = array();

        /**
         * Chemin de base du dossier log de l'application
         */
        private static $cheminLogs = '';

        /**
         * Booleen indiquant si l'on peut correctement écrire dans les fichiers de logs
         */
         private static $droitLogger = true;

        /**
         * Zone horaire (pour éviter des avertissements dans les dates)
         */
        private static $timeZone = 'Europe/Paris';

        /**
         * Taille maximum d'un fichier de log avant que celui ne soit archivé (en octets)
         */
        private static $tailleMax = 10000;

        /**
         * séparateur de dossier dans un chemin
         */
        private static $sd = DIRECTORY_SEPARATOR;

        /**
         * Extension des fichiers de log
         */
        private static $ext = '.log';

        /**
         * Initialiser les logs par défaut, sans tenir comptes des paramêtres de config.
         */
        public static function initialiser() {
                // gestion de la timezone pour éviter des erreurs
                if (function_exists('date_default_timezone_set') && function_exists('date_default_timezone_get')) {
                        date_default_timezone_set(self::$timeZone);
                }

                if (self::$logger && (!is_dir(self::$cheminLogs) || !is_writable(self::$cheminLogs))) {
                        self::desactiverEcriture();
                }
        }
        
        /**
         * Configure le Log à partir des paramêtres de config.
         */
        public static function configurer() {
                self::$sd = Config::get('ds');
                self::$cheminLogs = Config::get('chemin_logs');
                self::$timeZone = (Config::get('fw_timezone') != '') ? Config::get('fw_timezone') : self::$timeZone;
                self::$tailleMax = (Config::get('fw_taille_max_logs') != '') ? Config::get('fw_taille_max_logs') : self::$tailleMax;
                self::$logger = (Config::get('fw_log_debogage') != '') ? Config::get('fw_log_debogage') : self::$logger;
                self::initialiser();
        }

        /**
         * Ajoute une entrée au log spécifié par le paramètre $nomFichier
         * @param string $nomFichier le nom du fichier dans lequel écrire
         */
        public static function ajouterEntree($nomFichier, $entree, $mode = 'a+') {
                if (self::$droitLogger) {
                        $date = "\n"."\n".date('d m Y H:i')."\n" ;

                        // si le fichier est déjà dans le tableau et qu'on peut y écrire
                        if(self::verifierOuvrirFichier($nomFichier,$mode)) {
                                // on y écrit le message de log
                           fwrite(self::$fichiersLog[$nomFichier],$date.$entree);
                           // on vérifie si le fichier ne dépasse pas la taille maximale
                           self::verifierTailleFichierOuArchiver($nomFichier);
                        } else {
                                // sinon on interdit l'écriture
                                self::desactiverEcriture($nomFichier);
                        }
                }
        }

        /**
         * Vide un fichier log indiqué
         * @param string $nomFichier le nom du fichier à vider
         */
        public static function viderLog($nomFichier) {
                self::ajouterEntree($nomFichier, '', 'w');
        }

        /**
         * Vérifie la présence d'un fichier dans le tableau, ses droits d'écriture, l'ouvre si nécessaire.
         * 
         * @param string $nomFichier le nom du fichier dont on doit vérifier la présence
         * @return boolean true si le fichier est ouvert ou maintenant accessible, false sinon
         */
        public static function verifierOuvrirFichier($nomFichier,$mode) {
                // le fichier est il déjà ouvert ?
                if (in_array($nomFichier, self::$fichiersLog)) {
                        // si oui peut on y écrire ?
                        if (is_writable(self::$cheminLogs.$nomFichier.self::$ext)) {
                                // si oui on renvoie le descripteur
                                return true;
                        }
                        return false;
                } else {
                        // sinon on l'ouvre
                        $fp = @fopen(self::$cheminLogs.$nomFichier.self::$ext,$mode);
                        // si l'ouverture a réussi et si le fichier a les droits d'écriture
                        if ($fp && is_writable(self::$cheminLogs.$nomFichier.self::$ext)) {
                                // si oui on renvoie le descripteur qu'on ajoute au tableau
                                self::$fichiersLog[$nomFichier] = $fp;
                                return true;
                        }
                        return false;
                }
        }

        /**
         * Vérifie la taille d'un fichier donné et si celle ci est trop importante
         * archive le fichier de log
         * @param string $nomFichier nom du fichier à vérifier
         */
        private static function verifierTailleFichierOuArchiver($nomFichier) {
                if(filesize(self::$cheminLogs.$nomFichier.self::$ext) > self::$tailleMax) {
                        rename(self::$cheminLogs.$nomFichier.self::$ext,self::$cheminLogs.$nomFichier.date('d_m_Y_H:i').self::$ext);
                        self::ajouterEntree($nomFichier,'');
                }
        }

        /**
         * Désactive l'écriture du log et envoie un message au gestionnaire d'erreurs
         * @param string $nomFichier le nom du fichier qui a causé l'erreur
         */
        private static function desactiverEcriture($nomFichier = '') {
                self::$droitLogger = false;
                if ($nomFichier != '') {
                        $fichierDossier = 'fichier '.$nomFichier ;
                } else {
                        $fichierDossier = 'dossier des logs';
                }
                $message = 'Écriture impossible dans le '.$fichierDossier.', Assurez-vous des droits du dossier et des fichiers';
                $e = new ErrorException($message, 0, E_USER_WARNING, __FILE__, __LINE__);
                GestionnaireException::gererException($e);
        }

        /**
         * destructeur de classe, ferme les descripteurs ouverts
         */
        public function __destruct() {
                foreach(self::$fichiersLog as $nomFichier => $fp) {
                        fclose($fp);
                }
        }
}
?>