Subversion Repositories Applications.framework

Rev

Rev 210 | Rev 241 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
122 aurelien 1 
<?php
2 
//declare(encoding='UTF-8');
3 
/**
189 jpm 4 
 * Classe permettant de logger des messages dans les fichier situés dans le dossier de log.
129 aurelien 5 
 *
189 jpm 6 
 * @category	PHP 5.2
7 
 * @package		Framework
8 
 * @author		aurelien <aurelien@tela-botanica.org>
9 
 * @copyright	2009 Tela-Botanica
10 
 * @license     http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
11 
 * @version   SVN: $Id: Log.php 230 2010-11-16 16:22:48Z jpm $
129 aurelien 12 
 * @link	  /doc/framework/
13 
 */
122 aurelien 14 
 
15 
class Log {
16 
 
123 aurelien 17 
	/**
175 aurelien 18 
	 * Boolean indiquant si l'on doit utiliser les logs ou pas
19 
	 */
20 
	private static $logger = false;
21 
 
22 
	/**
123 aurelien 23 
	 * Tableau associatif stockant les descripteurs de fichiers
24 
	 */
25 
	private static $fichiersLog = array();
122 aurelien 26 
 
123 aurelien 27 
	/**
28 
	 * Chemin de base du dossier log de l'application
29 
	 */
30 
	private static $cheminLogs = '';
122 aurelien 31 
 
123 aurelien 32 
	/**
33 
	 * Booleen indiquant si l'on peut correctement écrire dans les fichiers de logs
34 
	 */
35 
	 private static $droitLogger = true;
122 aurelien 36 
 
123 aurelien 37 
	/**
38 
	 * Zone horaire (pour éviter des avertissements dans les dates)
39 
	 */
189 jpm 40 
	private static $timeZone = 'Europe/Paris';
122 aurelien 41 
 
123 aurelien 42 
	/**
129 aurelien 43 
	 * Taille maximum d'un fichier de log avant que celui ne soit archivé (en octets)
44 
	 */
45 
	private static $tailleMax = 10000;
46 
 
47 
	/**
189 jpm 48 
	 * séparateur de dossier dans un chemin
123 aurelien 49 
	 */
50 
	private static $sd = DIRECTORY_SEPARATOR;
122 aurelien 51 
 
123 aurelien 52 
	/**
129 aurelien 53 
	 * Extension des fichiers de log
54 
	 */
55 
	private static $ext = '.log';
56 
 
57 
	/**
189 jpm 58 
	 * Initialiser les logs par défaut, sans tenir comptes des paramêtres de config.
123 aurelien 59 
	 */
189 jpm 60 
	public static function initialiser() {
129 aurelien 61 
		// gestion de la timezone pour éviter des erreurs
138 jpm 62 
		if (function_exists('date_default_timezone_set') && function_exists('date_default_timezone_get')) {
129 aurelien 63 
			date_default_timezone_set(self::$timeZone);
64 
		}
65 
 
175 aurelien 66 
		if (self::$logger && (!is_dir(self::$cheminLogs) || !is_writable(self::$cheminLogs))) {
129 aurelien 67 
			self::desactiverEcriture();
68 
		}
123 aurelien 69 
	}
189 jpm 70 
 
123 aurelien 71 
	/**
189 jpm 72 
	 * Configure le Log à partir des paramêtres de config.
123 aurelien 73 
	 */
189 jpm 74 
	public static function configurer() {
75 
		self::$sd = Config::get('ds');
76 
		self::$cheminLogs = Config::get('chemin_logs');
202 jpm 77 
		self::$timeZone = Config::get('i18n_timezone');
189 jpm 78 
		self::$tailleMax = Config::get('fw_taille_max_logs');
79 
		self::$logger = Config::get('fw_log_debogage');
80 
		self::initialiser();
123 aurelien 81 
	}
122 aurelien 82 
 
123 aurelien 83 
	/**
84 
	 * Ajoute une entrée au log spécifié par le paramètre $nomFichier
85 
	 * @param string $nomFichier le nom du fichier dans lequel écrire
86 
	 */
189 jpm 87 
	public static function ajouterEntree($nomFichier, $entree, $mode = 'a+') {
88 
		if (self::$droitLogger) {
123 aurelien 89 
			$date = "\n"."\n".date('d m Y H:i')."\n" ;
122 aurelien 90 
 
210 jpm 91 
			if (self::verifierOuvrirFichier($nomFichier, $mode)) {
92 
			   fwrite(self::$fichiersLog[$nomFichier], $date.$entree);
138 jpm 93 
			   self::verifierTailleFichierOuArchiver($nomFichier);
123 aurelien 94 
			} else {
129 aurelien 95 
				self::desactiverEcriture($nomFichier);
123 aurelien 96 
			}
97 
		}
98 
	}
122 aurelien 99 
 
123 aurelien 100 
	/**
101 
	 * Vide un fichier log indiqué
102 
	 * @param string $nomFichier le nom du fichier à vider
103 
	 */
104 
	public static function viderLog($nomFichier) {
163 aurelien 105 
		self::ajouterEntree($nomFichier, '', 'w');
123 aurelien 106 
	}
122 aurelien 107 
 
123 aurelien 108 
	/**
189 jpm 109 
	 * Vérifie la présence d'un fichier dans le tableau, ses droits d'écriture, l'ouvre si nécessaire.
110 
	 *
123 aurelien 111 
	 * @param string $nomFichier le nom du fichier dont on doit vérifier la présence
129 aurelien 112 
	 * @return boolean true si le fichier est ouvert ou maintenant accessible, false sinon
123 aurelien 113 
	 */
129 aurelien 114 
	public static function verifierOuvrirFichier($nomFichier,$mode) {
138 jpm 115 
		if (in_array($nomFichier, self::$fichiersLog)) {
116 
			if (is_writable(self::$cheminLogs.$nomFichier.self::$ext)) {
129 aurelien 117 
				return true;
118 
			}
119 
			return false;
120 
		} else {
121 
			$fp = @fopen(self::$cheminLogs.$nomFichier.self::$ext,$mode);
138 jpm 122 
			if ($fp && is_writable(self::$cheminLogs.$nomFichier.self::$ext)) {
129 aurelien 123 
				self::$fichiersLog[$nomFichier] = $fp;
124 
				return true;
125 
			}
126 
			return false;
123 aurelien 127 
		}
128 
	}
122 aurelien 129 
 
123 aurelien 130 
	/**
129 aurelien 131 
	 * Vérifie la taille d'un fichier donné et si celle ci est trop importante
132 
	 * archive le fichier de log
133 
	 * @param string $nomFichier nom du fichier à vérifier
134 
	 */
135 
	private static function verifierTailleFichierOuArchiver($nomFichier) {
136 
		if(filesize(self::$cheminLogs.$nomFichier.self::$ext) > self::$tailleMax) {
137 
			rename(self::$cheminLogs.$nomFichier.self::$ext,self::$cheminLogs.$nomFichier.date('d_m_Y_H:i').self::$ext);
163 aurelien 138 
			self::ajouterEntree($nomFichier,'');
129 aurelien 139 
		}
140 
	}
141 
 
142 
	/**
123 aurelien 143 
	 * Désactive l'écriture du log et envoie un message au gestionnaire d'erreurs
144 
	 * @param string $nomFichier le nom du fichier qui a causé l'erreur
145 
	 */
129 aurelien 146 
	private static function desactiverEcriture($nomFichier = '') {
123 aurelien 147 
		self::$droitLogger = false;
138 jpm 148 
		if ($nomFichier != '') {
129 aurelien 149 
			$fichierDossier = 'fichier '.$nomFichier ;
150 
		} else {
151 
			$fichierDossier = 'dossier des logs';
152 
		}
138 jpm 153 
		$message = 'Écriture impossible dans le '.$fichierDossier.', Assurez-vous des droits du dossier et des fichiers';
154 
		$e = new ErrorException($message, 0, E_USER_WARNING, __FILE__, __LINE__);
123 aurelien 155 
		GestionnaireException::gererException($e);
156 
	}
122 aurelien 157 
 
123 aurelien 158 
	/**
159 
	 * destructeur de classe, ferme les descripteurs ouverts
160 
	 */
161 
	public function __destruct() {
162 
		foreach(self::$fichiersLog as $nomFichier => $fp) {
163 
			fclose($fp);
164 
		}
165 
	}
122 aurelien 166 
}
230 jpm 167 
?>