WebSVN – Applications.framework – Diff – /trunk/framework/GestionnaireException.php


<?php
// declare(encoding='UTF-8');
/**
 * Classe de gestion des exceptions.
 * C'est un Singleton.
 *
 * PHP Version 5
 *
 * @category  Class
 * @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
 * @license   http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
 * @version   SVN: $$Id: GestionnaireException.php 192 2010-04-29 15:36:52Z jpm $$
 * @link	  /doc/framework/
 *
 */
class GestionnaireException {
	
	const MODE_CLI = 'cli';
	
	/** Liste des exceptions enregistrées */
 
	private static $exceptions = array();
 
 
 
	/** Détermine si l'on affiche ou non le contexte */
 
	private static $contexte = false;
 
 
 
	 /** Détermine si l'on loggue ou non les erreurs */
 
	private static $logger = false;
 
 
 
	/** Détermine si l'affichage des erreurs est forcé (true) ou pas (false) à la destruction de la classe */
 
	private static $afficher = false;
 
 
	/** Definit si php est lancé en ligne de commande ou en mode serveur */
	private static $mode = null ;
 
	/** Initialise le Gestionnaire d'exceptions et d'erreur sans tenir comptes des paramêtres de config. */
	public static function initialiser() {
		self::$mode = php_sapi_name();
		// Désactivation des balises HTML dans les messages d'erreur de PHP en mode ligne de commande
		if (self::$mode == self::MODE_CLI) {
			ini_set('html_errors', 0);
		} 
		
		set_exception_handler(array(get_class(),'gererException'));
		set_error_handler(array(get_class(),'gererErreur'));
	}
 
	
 
	/** Configure le Gestionnaire d'exceptions et d'erreur à partir des paramêtres de config. */
	public static function configurer() {
		self::$contexte = Config::get('fw_debogage_contexte');
		self::$logger = Config::get('fw_log_debogage');
		self::$afficher = Config::get('fw_debogage');
	}
 
	
 
	/** Renvoie le booleen définissant si l'on affiche le contexte ou non */
	public static function getContexte() {
		return self::$contexte;
	}
 
	/**
	 * Definit si l'on veut afficher le contexte ou non
	 * @param bool true si on veut afficher le contexte, false sinon, par défaut vaut false
	 */
	public static function setContexte($contexte) {
		self::$contexte = $contexte;
	}
 
	/**
	 * Fonction de gestion des exceptions, remplace le handler par défaut
	 * @param Exception $e l'exception à traiter
	 */
	public static function gererException(Exception $e) {
		// pour le moment on se contente de l'ajouter au tableau et de les afficher
		self::$exceptions[] = $e;
		// Log si nécéssaire
		self::loggerException($e);
	}
 
	/**
	 * Gère les erreurs en les convertissant en exceptions (remplace la fonction gestion d'erreurs native de php)
	 * @param int $niveau le niveau de l'erreur
	 * @param string $message le message associé à l'erreur
	 * @param string $fichier le nom du fichier où l'erreur s'est produite
	 * @param int $ligne la ligne où l'erreur s'est produite
	 * @param string $contexte le contexte associé à l'erreur
	 */
	public static function gererErreur($niveau,  $message,  $fichier,  $ligne,  $contexte){
		// Si un rapport d'erreur existe, création d'une exception
		if (error_reporting() != 0) {
			$e = new ErrorException($message, 0, $niveau, $fichier, $ligne);
			// que l'on donne au tableau d'exceptions
			self::$exceptions[] = $e;
			// Log si nécéssaire
			self::loggerException($e);			
		}
		return null;
	}
 
	/**
	 * Renvoie les exceptions au format (X)HTML
	 * ou bien au format texte suivant le mode d'utilisation de PHP
	 */
	public static function getExceptions() {
		$retour = '';
		foreach (self::$exceptions as $cle => $e) {
			switch (self::$mode) {
				case self::MODE_CLI :
					$retour .= $e->getMessage()."\n";
					$retour .= 'Fichier : '.$e->getFile()."\n";
					$retour .= 'Ligne : '.$e->getLine()."\n";
					if (self::getContexte()) {
						$retour .= 'Contexte : '."\n".print_r($e->getTraceAsString(), true)."\n";
					}
					break;
				default:
					$retour .= '<pre class="debogage">'."\n";
					$retour .= $e->getMessage()."\n";
					$retour .= '<span class="debogage_fichier">'.'Fichier : '.$e->getFile().'</span>'."\n";
					$retour .= '<span class="debogage_ligne">'.'Ligne : '.$e->getLine().'</span>'."\n";
					$retour .= '</pre>'."\n";
 
					if (self::getContexte()) {
						$retour .= '<pre>'."\n";
						$retour .= '<strong>Contexte : </strong>'."\n".print_r($e->getTraceAsString(), true)."\n";
						$retour .= '</pre>'."\n";
					}
			}
			// Nous vidons le tableau des exceptions au fur et à mesure
			unset(self::$exceptions[$cle]);
		}
		return $retour;
	}
 
	/**
	 * Logue une exception donnée sous une forme lisible si self::logger vaut true.
	 * @param Exception	$e l'exception à logger
	 */
	private static function loggerException($e) {
		if (self::$logger) {
			$erreur = '';
			$erreur .= $e->getMessage()."\n";
			$erreur .= 'Fichier : '.$e->getFile()."\n";
			$erreur .= 'Ligne : '.$e->getLine()."\n";
			if (self::getContexte()) {
				$erreur .= 'Contexte : '."\n".print_r($e->getTraceAsString(), true)."\n";
			}
			$erreur .= "\n";
			Log::ajouterEntree('erreurs', $erreur);
		}
	}
 
	public function __destruct() {
		// Si des erreurs n'ont pas été affichée nous forçons leur affichage
		if (self::$afficher && count(self::$exceptions) > 0) {
			echo self::getExceptions();
		}
	}
 
}
?>

Rev 189	Rev 192
1	`<?php`	1	`<?php`
2	`// declare(encoding='UTF-8');`	2	`// declare(encoding='UTF-8');`
3	`/**`	3	`/**`
4	`* Classe de gestion des exceptions.`	4	`* Classe de gestion des exceptions.`
5	`* C'est un Singleton.`	5	`* C'est un Singleton.`
6	`*`	6	`*`
7	`* PHP Version 5`	7	`* PHP Version 5`
8	`*`	8	`*`
9	`* @category Class`	9	`* @category Class`
10	`* @package Framework`	10	`* @package Framework`
11	`* @author aurelien <aurelien@tela-botanica.org>`	11	`* @author aurelien <aurelien@tela-botanica.org>`
12	`* @copyright 2009 Tela-Botanica`	12	`* @copyright 2009 Tela-Botanica`
13	`* @license http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL`	13	`* @license http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL`
14	`* @license http://www.gnu.org/licenses/gpl.html Licence GNU-GPL`	14	`* @license http://www.gnu.org/licenses/gpl.html Licence GNU-GPL`
15	`* @version SVN: $$Id: GestionnaireException.php 189 2010-04-29 12:22:04Z jpm $$`	15	`* @version SVN: $$Id: GestionnaireException.php 192 2010-04-29 15:36:52Z jpm $$`
16	`* @link /doc/framework/`	16	`* @link /doc/framework/`
17	`*`	17	`*`
18	`*/`	18	`*/`
19	`class GestionnaireException {`	19	`class GestionnaireException {`
20		20
-		21	`const MODE_CLI = 'cli';`
21	`/**`	22
22	`* Liste des exceptions enregistrées`	23	`/** Liste des exceptions enregistrées */`
23	`*/`	-
24	`private static $exceptions = array();`	24	`private static $exceptions = array();`
25		-
26	`/**`	25
27	`* Détermine si l'on affiche ou non le contexte`	-
28	`*/`	26	`/** Détermine si l'on affiche ou non le contexte */`
29	`private static $contexte = false;`	-
30		27	`private static $contexte = false;`
31	`/**`	-
32	`* Détermine si l'on loggue ou non les erreurs`	28
33	`*/`	-
34	`private static $logger = false;`	29	`/** Détermine si l'on loggue ou non les erreurs */`
35		-
36	`/**`	30	`private static $logger = false;`
37	`* Détermine si l'affichage des erreurs est forcé (true) ou pas (false) à la destruction de la classe`	-
38	`*/`	31
39	`private static $afficher = false;`	-
40		32	`/** Détermine si l'affichage des erreurs est forcé (true) ou pas (false) à la destruction de la classe */`
41	`/**`	-
42	`* Definit si php est lancé en ligne de commande ou en mode serveur`	33	`private static $afficher = false;`
43	`*/`	-
44	`private static $mode = null ;`	34
45		35	`/** Definit si php est lancé en ligne de commande ou en mode serveur */`
-		36	`private static $mode = null ;`
-		37
-		38	`/** Initialise le Gestionnaire d'exceptions et d'erreur sans tenir comptes des paramêtres de config. */`
-		39	`public static function initialiser() {`
-		40	`self::$mode = php_sapi_name();`
46	`/**`	41	`// Désactivation des balises HTML dans les messages d'erreur de PHP en mode ligne de commande`
47	`* Initialise le Gestionnaire d'exceptions et d'erreur sans tenir comptes des paramêtres de config.`	42	`if (self::$mode == self::MODE_CLI) {`
48	`*/`	43	`ini_set('html_errors', 0);`
49	`public static function initialiser() {`	44	`}`
50	`self::$mode = php_sapi_name();`	45
51	`set_exception_handler(array(get_class(),'gererException'));`	46	`set_exception_handler(array(get_class(),'gererException'));`
52	`set_error_handler(array(get_class(),'gererErreur'));`	47	`set_error_handler(array(get_class(),'gererErreur'));`
53	`}`	48	`}`
54		-
55	`/**`	49
56	`* Configure le Gestionnaire d'exceptions et d'erreur à partir des paramêtres de config.`	-
57	`*/`	50	`/** Configure le Gestionnaire d'exceptions et d'erreur à partir des paramêtres de config. */`
58	`public static function configurer() {`	51	`public static function configurer() {`
59	`self::$contexte = Config::get('fw_debogage_contexte');`	52	`self::$contexte = Config::get('fw_debogage_contexte');`
60	`self::$logger = Config::get('fw_log_debogage');`	53	`self::$logger = Config::get('fw_log_debogage');`
61	`self::$afficher = Config::get('fw_debogage');`	54	`self::$afficher = Config::get('fw_debogage');`
62	`}`	55	`}`
63		-
64	`/**`	56
65	`* Renvoie le booleen définissant si l'on affiche le contexte ou non`	-
66	`*/`	57	`/** Renvoie le booleen définissant si l'on affiche le contexte ou non */`
67	`public static function getContexte() {`	58	`public static function getContexte() {`
68	`return self::$contexte;`	59	`return self::$contexte;`
69	`}`	60	`}`
70		61
71	`/**`	62	`/**`
72	`* Definit si l'on veut afficher le contexte ou non`	63	`* Definit si l'on veut afficher le contexte ou non`
73	`* @param bool true si on veut afficher le contexte, false sinon, par défaut vaut false`	64	`* @param bool true si on veut afficher le contexte, false sinon, par défaut vaut false`
74	`*/`	65	`*/`
75	`public static function setContexte($contexte) {`	66	`public static function setContexte($contexte) {`
76	`self::$contexte = $contexte;`	67	`self::$contexte = $contexte;`
77	`}`	68	`}`
78		69
79	`/**`	70	`/**`
80	`* Fonction de gestion des exceptions, remplace le handler par défaut`	71	`* Fonction de gestion des exceptions, remplace le handler par défaut`
81	`* @param Exception $e l'exception à traiter`	72	`* @param Exception $e l'exception à traiter`
82	`*/`	73	`*/`
83	`public static function gererException(Exception $e) {`	74	`public static function gererException(Exception $e) {`
84	`// pour le moment on se contente de l'ajouter au tableau et de les afficher`	75	`// pour le moment on se contente de l'ajouter au tableau et de les afficher`
85	`self::$exceptions[] = $e;`	76	`self::$exceptions[] = $e;`
86	`// Log si nécéssaire`	77	`// Log si nécéssaire`
87	`self::loggerException($e);`	78	`self::loggerException($e);`
88	`}`	79	`}`
89		80
90	`/**`	81	`/**`
91	`* Gère les erreurs en les convertissant en exceptions (remplace la fonction gestion d'erreurs native de php)`	82	`* Gère les erreurs en les convertissant en exceptions (remplace la fonction gestion d'erreurs native de php)`
92	`* @param int $niveau le niveau de l'erreur`	83	`* @param int $niveau le niveau de l'erreur`
93	`* @param string $message le message associé à l'erreur`	84	`* @param string $message le message associé à l'erreur`
94	`* @param string $fichier le nom du fichier où l'erreur s'est produite`	85	`* @param string $fichier le nom du fichier où l'erreur s'est produite`
95	`* @param int $ligne la ligne où l'erreur s'est produite`	86	`* @param int $ligne la ligne où l'erreur s'est produite`
96	`* @param string $contexte le contexte associé à l'erreur`	87	`* @param string $contexte le contexte associé à l'erreur`
97	`*/`	88	`*/`
98	`public static function gererErreur($niveau, $message, $fichier, $ligne, $contexte){`	89	`public static function gererErreur($niveau, $message, $fichier, $ligne, $contexte){`
99	`// Si un rapport d'erreur existe, création d'une exception`	90	`// Si un rapport d'erreur existe, création d'une exception`
100	`if (error_reporting() != 0) {`	91	`if (error_reporting() != 0) {`
101	`$e = new ErrorException($message, 0, $niveau, $fichier, $ligne);`	92	`$e = new ErrorException($message, 0, $niveau, $fichier, $ligne);`
102	`// que l'on donne au tableau d'exceptions`	93	`// que l'on donne au tableau d'exceptions`
103	`self::$exceptions[] = $e;`	94	`self::$exceptions[] = $e;`
104	`// Log si nécéssaire`	95	`// Log si nécéssaire`
105	`self::loggerException($e);`	96	`self::loggerException($e);`
106	`}`	97	`}`
107	`return null;`	98	`return null;`
108	`}`	99	`}`
109		100
110	`/**`	101	`/**`
111	`* Renvoie les exceptions au format (X)HTML`	102	`* Renvoie les exceptions au format (X)HTML`
112	`* ou bien au format texte suivant le mode d'utilisation de PHP`	103	`* ou bien au format texte suivant le mode d'utilisation de PHP`
113	`*/`	104	`*/`
114	`public static function getExceptions() {`	105	`public static function getExceptions() {`
115	`$retour = '';`	106	`$retour = '';`
116	`foreach (self::$exceptions as $cle => $e) {`	107	`foreach (self::$exceptions as $cle => $e) {`
117	`switch (self::$mode) {`	108	`switch (self::$mode) {`
118	`case 'cli' :`	109	`case self::MODE_CLI :`
119	`$retour .= $e->getMessage()."\n";`	110	`$retour .= $e->getMessage()."\n";`
120	`$retour .= 'Fichier : '.$e->getFile()."\n";`	111	`$retour .= 'Fichier : '.$e->getFile()."\n";`
121	`$retour .= 'Ligne : '.$e->getLine()."\n";`	112	`$retour .= 'Ligne : '.$e->getLine()."\n";`
122	`if (self::getContexte()) {`	113	`if (self::getContexte()) {`
123	`$retour .= 'Contexte : '."\n".print_r($e->getTraceAsString(), true)."\n";`	114	`$retour .= 'Contexte : '."\n".print_r($e->getTraceAsString(), true)."\n";`
124	`}`	115	`}`
125	`break;`	116	`break;`
126	`default:`	117	`default:`
127	`$retour .= '<pre class="debogage">'."\n";`	118	`$retour .= '<pre class="debogage">'."\n";`
128	`$retour .= $e->getMessage()."\n";`	119	`$retour .= $e->getMessage()."\n";`
129	`$retour .= '<span class="debogage_fichier">'.'Fichier : '.$e->getFile().'</span>'."\n";`	120	`$retour .= '<span class="debogage_fichier">'.'Fichier : '.$e->getFile().'</span>'."\n";`
130	`$retour .= '<span class="debogage_ligne">'.'Ligne : '.$e->getLine().'</span>'."\n";`	121	`$retour .= '<span class="debogage_ligne">'.'Ligne : '.$e->getLine().'</span>'."\n";`
131	`$retour .= '</pre>'."\n";`	122	`$retour .= '</pre>'."\n";`
132		123
133	`if (self::getContexte()) {`	124	`if (self::getContexte()) {`
134	`$retour .= '<pre>'."\n";`	125	`$retour .= '<pre>'."\n";`
135	`$retour .= '<strong>Contexte : </strong>'."\n".print_r($e->getTraceAsString(), true)."\n";`	126	`$retour .= '<strong>Contexte : </strong>'."\n".print_r($e->getTraceAsString(), true)."\n";`
136	`$retour .= '</pre>'."\n";`	127	`$retour .= '</pre>'."\n";`
137	`}`	128	`}`
138	`}`	129	`}`
139	`// Nous vidons le tableau des exceptions au fur et à mesure`	130	`// Nous vidons le tableau des exceptions au fur et à mesure`
140	`unset(self::$exceptions[$cle]);`	131	`unset(self::$exceptions[$cle]);`
141	`}`	132	`}`
142	`return $retour;`	133	`return $retour;`
143	`}`	134	`}`
144		135
145	`/**`	136	`/**`
146	`* Logue une exception donnée sous une forme lisible si self::logger vaut true.`	137	`* Logue une exception donnée sous une forme lisible si self::logger vaut true.`
147	`* @param Exception $e l'exception à logger`	138	`* @param Exception $e l'exception à logger`
148	`*/`	139	`*/`
149	`private static function loggerException($e) {`	140	`private static function loggerException($e) {`
150	`if (self::$logger) {`	141	`if (self::$logger) {`
151	`$erreur = '';`	142	`$erreur = '';`
152	`$erreur .= $e->getMessage()."\n";`	143	`$erreur .= $e->getMessage()."\n";`
153	`$erreur .= 'Fichier : '.$e->getFile()."\n";`	144	`$erreur .= 'Fichier : '.$e->getFile()."\n";`
154	`$erreur .= 'Ligne : '.$e->getLine()."\n";`	145	`$erreur .= 'Ligne : '.$e->getLine()."\n";`
155	`if (self::getContexte()) {`	146	`if (self::getContexte()) {`
156	`$erreur .= 'Contexte : '."\n".print_r($e->getTraceAsString(), true)."\n";`	147	`$erreur .= 'Contexte : '."\n".print_r($e->getTraceAsString(), true)."\n";`
157	`}`	148	`}`
158	`$erreur .= "\n";`	149	`$erreur .= "\n";`
159	`Log::ajouterEntree('erreurs', $erreur);`	150	`Log::ajouterEntree('erreurs', $erreur);`
160	`}`	151	`}`
161	`}`	152	`}`
162		153
163	`public function __destruct() {`	154	`public function __destruct() {`
164	`// Si des erreurs n'ont pas été affichée nous forçons leur affichage`	155	`// Si des erreurs n'ont pas été affichée nous forçons leur affichage`
165	`if (self::$afficher && count(self::$exceptions) > 0) {`	156	`if (self::$afficher && count(self::$exceptions) > 0) {`
166	`echo self::getExceptions();`	157	`echo self::getExceptions();`
167	`}`	158	`}`
168	`}`	159	`}`
169		160
170	`}`	161	`}`
171	`?>`	162	`?>`

Subversion Repositories Applications.framework

(root)/trunk/framework/GestionnaireException.php @ 485 – Rev 189 → 192