WebSVN – Applications.framework – Diff – /branches/v0.3-aleaume/framework/GestionnaireException.php


<?php
// declare(encoding='UTF-8');
/**
 * classe de gestion des exceptions.
 *
 * 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 135 2009-11-30 12:46:23Z aurelien $$
 * @link	  /doc/framework/
 *
 */
class GestionnaireException {
 
	/**
	 * 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;
 
	/**
	 * Definit si php est lancé en ligne de commande ou en mode serveur
	 */
	private static $mode = php_sapi_name ;
 
	/**
	 * le gestionnaire d'exception est un singleton
	 * et possède donc un "pointeur statique sur lui-même"
	 */
	private static $gestionnaireException;
 
	/**
	 * Constructeur avec paramètres optionnel
	 * @param bool indique si l'on veut afficher ou non le contexte des exceptions (i.e. la trace)
	 */
	public function __construct() {
		self::$exceptions = array();
		self::$contexte = Config::get('fw_debogage_contexte');
		self::$logger = Config::get('fw_log_debogage');
		self::$mode = php_sapi_name();
 
		set_exception_handler(array(get_class($this),'gererException'));
		set_error_handler(array(get_class($this),'gererErreur'));
	}
 
	/**
	 * 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 function setContexte($contexte) {
		self::$contexte = $contexte;
	}
 
	 /** Fonction d'accès au singleton
	 * @return GestionnaireErreur le gestionnaire d'exceptions courant
	 */
	public static function getInstance() {
		if (self::$gestionnaireException instanceof GestionnaireException) {
			return self::$gestionnaireException;
		}
		self::$gestionnaireException = new GestionnaireException;
 
		return self::$gestionnaireException;
	}
 
	/**
	 * 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;
 
		// si on doit logger on envoie l'exception au loggeur
		if(self::$logger) {
			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 aucun rapport d'erreur, on sort directement
		if (error_reporting() == 0)
		{
			return;
		}
 
		// sinon on crée une exception
		$e = new ErrorException($message, 0, $niveau, $fichier, $ligne);
		// que l'on donne au tableau d'exceptions
		self::$exceptions[] = $e;
		// on la logge si nécéssaire
		if(self::$logger) {
			self::loggerException($e);
		}
		return;
	}
 
	/**
	 * 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 $e) {
			switch(self::$mode) {
				case '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";
					}
			}
		}
		return $retour;
	}
 
	/**
	 * logge une exception donnée sous une forme lisible
	 * @param Exception	$e l'exception à logger
	 */
	private static function loggerException($e) {
 
		$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() {
		echo self::getExceptions();
	}
 
}
?>

Subversion Repositories Applications.framework

(root)/branches/v0.3-aleaume/framework/GestionnaireException.php @ 399 – Rev 129 → 135

Rev 129		Rev 135
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	`*`	5	`*`
6	`* PHP Version 5`	6	`* PHP Version 5`
7	`*`	7	`*`
8	`* @category Class`	8	`* @category Class`
9	`* @package Framework`	9	`* @package Framework`
10	`* @author aurelien <aurelien@tela-botanica.org>`	10	`* @author aurelien <aurelien@tela-botanica.org>`
11	`* @copyright 2009 Tela-Botanica`	11	`* @copyright 2009 Tela-Botanica`
12	`* @license http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL`	12	`* @license http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL`
13	`* @license http://www.gnu.org/licenses/gpl.html Licence GNU-GPL`	13	`* @license http://www.gnu.org/licenses/gpl.html Licence GNU-GPL`
14	`* @version SVN: $$Id: GestionnaireException.php 129 2009-09-02 12:22:03Z aurelien $$`	14	`* @version SVN: $$Id: GestionnaireException.php 135 2009-11-30 12:46:23Z aurelien $$`
15	`* @link /doc/framework/`	15	`* @link /doc/framework/`
16	`*`	16	`*`
17	`*/`	17	`*/`
18	`class GestionnaireException {`	18	`class GestionnaireException {`
19		19
20	`/**`	20	`/**`
21	`* Liste des exceptions enregistrées`	21	`* Liste des exceptions enregistrées`
22	`*/`	22	`*/`
23	`private static $exceptions = array();`	23	`private static $exceptions = array();`
24		24
25	`/**`	25	`/**`
26	`* Détermine si l'on affiche ou non le contexte`	26	`* Détermine si l'on affiche ou non le contexte`
27	`*/`	27	`*/`
28	`private static $contexte = false;`	28	`private static $contexte = false;`
29		29
30	`/**`	30	`/**`
31	`* Détermine si l'on loggue ou non les erreurs`	31	`* Détermine si l'on loggue ou non les erreurs`
32	`*/`	32	`*/`
33	`private static $logger = false;`	33	`private static $logger = false;`
34		34
35	`/**`	35	`/**`
36	`* Definit si php est lancé en ligne de commande ou en mode serveur`	36	`* Definit si php est lancé en ligne de commande ou en mode serveur`
37	`*/`	37	`*/`
38	`private static $mode = php_sapi_name ;`	38	`private static $mode = php_sapi_name ;`
39		39
40	`/**`	40	`/**`
41	`* le gestionnaire d'exception est un singleton`	41	`* le gestionnaire d'exception est un singleton`
42	`* et possède donc un "pointeur statique sur lui-même"`	42	`* et possède donc un "pointeur statique sur lui-même"`
43	`*/`	43	`*/`
44	`private static $gestionnaireException;`	44	`private static $gestionnaireException;`
45		45
46	`/**`	46	`/**`
47	`* Constructeur avec paramètres optionnel`	47	`* Constructeur avec paramètres optionnel`
48	`* @param bool indique si l'on veut afficher ou non le contexte des exceptions (i.e. la trace)`	48	`* @param bool indique si l'on veut afficher ou non le contexte des exceptions (i.e. la trace)`
49	`*/`	49	`*/`
50	`public function __construct() {`	50	`public function __construct() {`
51	`self::$exceptions = array();`	51	`self::$exceptions = array();`
52	`self::$contexte = Config::get('fw_debogage_contexte');`	52	`self::$contexte = Config::get('fw_debogage_contexte');`
53	`self::$logger = Config::get('fw_log_debogage');`	53	`self::$logger = Config::get('fw_log_debogage');`
54	`self::$mode = php_sapi_name();`	54	`self::$mode = php_sapi_name();`
55		55
56	`set_exception_handler(array(get_class($this),'gererException'));`	56	`set_exception_handler(array(get_class($this),'gererException'));`
57	`set_error_handler(array(get_class($this),'gererErreur'));`	57	`set_error_handler(array(get_class($this),'gererErreur'));`
58	`}`	58	`}`
59		59
60	`/**`	60	`/**`
61	`* Renvoie le booleen définissant si l'on affiche le contexte ou non`	61	`* Renvoie le booleen définissant si l'on affiche le contexte ou non`
62	`*/`	62	`*/`
63	`public static function getContexte() {`	63	`public static function getContexte() {`
64	`return self::$contexte;`	64	`return self::$contexte;`
65	`}`	65	`}`
66		66
67	`/**`	67	`/**`
68	`* Definit si l'on veut afficher le contexte ou non`	68	`* Definit si l'on veut afficher le contexte ou non`
69	`* @param bool true si on veut afficher le contexte, false sinon, par défaut vaut false`	69	`* @param bool true si on veut afficher le contexte, false sinon, par défaut vaut false`
70	`*/`	70	`*/`
71	`public function setContexte($contexte) {`	71	`public function setContexte($contexte) {`
72	`self::$contexte = $contexte;`	72	`self::$contexte = $contexte;`
73	`}`	73	`}`
74		74
75	`/** Fonction d'accès au singleton`	75	`/** Fonction d'accès au singleton`
76	`* @return GestionnaireErreur le gestionnaire d'exceptions courant`	76	`* @return GestionnaireErreur le gestionnaire d'exceptions courant`
77	`*/`	77	`*/`
78	`public static function getInstance() {`	78	`public static function getInstance() {`
79	`if (self::$gestionnaireException instanceof GestionnaireException) {`	79	`if (self::$gestionnaireException instanceof GestionnaireException) {`
80	`return self::$gestionnaireException;`	80	`return self::$gestionnaireException;`
81	`}`	81	`}`
82	`self::$gestionnaireException = new GestionnaireException;`	82	`self::$gestionnaireException = new GestionnaireException;`
83		83
84	`return self::$gestionnaireException;`	84	`return self::$gestionnaireException;`
85	`}`	85	`}`
86		86
87	`/**`	87	`/**`
88	`* Fonction de gestion des exceptions, remplace le handler par défaut`	88	`* Fonction de gestion des exceptions, remplace le handler par défaut`
89	`* @param Exception $e l'exception à traiter`	89	`* @param Exception $e l'exception à traiter`
90	`*/`	90	`*/`
91	`public static function gererException(Exception $e) {`	91	`public static function gererException(Exception $e) {`
92		92
93	`// pour le moment on se contente de l'ajouter au tableau et de les afficher`	93	`// pour le moment on se contente de l'ajouter au tableau et de les afficher`
94	`self::$exceptions[] = $e;`	94	`self::$exceptions[] = $e;`
95		95
96	`// si on doit logger on envoie l'exception au loggeur`	96	`// si on doit logger on envoie l'exception au loggeur`
97	`if(self::$logger) {`	97	`if(self::$logger) {`
98	`self::loggerException($e);`	98	`self::loggerException($e);`
99	`}`	99	`}`
100		-
101	`// si l'exception n'est pas permise par error reporting, on affiche les exceptions`	-
102	`if($e->getCode() != 0 && $e->getCode() <= error_reporting()) {`	-
103	`echo self::getExceptions();`	-
104	`return;`	-
105	`}`	-
106	`}`	100	`}`
107		101
108	`/**`	102	`/**`
109	`* Gère les erreurs en les convertissant en exceptions (remplace la fonction gestion d'erreurs native de php)`	103	`* Gère les erreurs en les convertissant en exceptions (remplace la fonction gestion d'erreurs native de php)`
110	`* @param int $niveau le niveau de l'erreur`	104	`* @param int $niveau le niveau de l'erreur`
111	`* @param string $message le message associé à l'erreur`	105	`* @param string $message le message associé à l'erreur`
112	`* @param string $fichier le nom du fichier où l'erreur s'est produite`	106	`* @param string $fichier le nom du fichier où l'erreur s'est produite`
113	`* @param int $ligne la ligne où l'erreur s'est produite`	107	`* @param int $ligne la ligne où l'erreur s'est produite`
114	`* @param string $contexte le contexte associé à l'erreur`	108	`* @param string $contexte le contexte associé à l'erreur`
115	`*/`	109	`*/`
116	`public static function gererErreur($niveau, $message, $fichier, $ligne, $contexte){`	110	`public static function gererErreur($niveau, $message, $fichier, $ligne, $contexte){`
117	`// si aucun rapport d'erreur, on sort directement`	111	`// si aucun rapport d'erreur, on sort directement`
118	`if (error_reporting() == 0)`	112	`if (error_reporting() == 0)`
119	`{`	113	`{`
120	`return;`	114	`return;`
121	`}`	115	`}`
122		116
123	`// sinon on crée une exception`	117	`// sinon on crée une exception`
124	`$e = new ErrorException($message, 0, $niveau, $fichier, $ligne);`	118	`$e = new ErrorException($message, 0, $niveau, $fichier, $ligne);`
125	`// que l'on donne au tableau d'exceptions`	119	`// que l'on donne au tableau d'exceptions`
126	`self::$exceptions[] = $e;`	120	`self::$exceptions[] = $e;`
127	`// on la logge si nécéssaire`	121	`// on la logge si nécéssaire`
128	`if(self::$logger) {`	122	`if(self::$logger) {`
129	`self::loggerException($e);`	123	`self::loggerException($e);`
130	`}`	124	`}`
131	`return;`	125	`return;`
132	`}`	126	`}`
133		127
134	`/**`	128	`/**`
135	`* Renvoie les exceptions au format (X)HTML`	129	`* Renvoie les exceptions au format (X)HTML`
136	`* ou bien au format texte suivant le mode d'utilisation de PHP`	130	`* ou bien au format texte suivant le mode d'utilisation de PHP`
137	`*/`	131	`*/`
138	`public static function getExceptions() {`	132	`public static function getExceptions() {`
139	`$retour = '';`	133	`$retour = '';`
140	`foreach (self::$exceptions as $e) {`	134	`foreach (self::$exceptions as $e) {`
141	`switch(self::$mode) {`	135	`switch(self::$mode) {`
142	`case 'cli' :`	136	`case 'cli' :`
143	`$retour .= $e->getMessage()."\n";`	137	`$retour .= $e->getMessage()."\n";`
144	`$retour .= 'Fichier : '.$e->getFile()."\n";`	138	`$retour .= 'Fichier : '.$e->getFile()."\n";`
145	`$retour .= 'Ligne : '.$e->getLine()."\n";`	139	`$retour .= 'Ligne : '.$e->getLine()."\n";`
146	`if (self::getContexte()) {`	140	`if (self::getContexte()) {`
147	`$retour .= 'Contexte : '."\n".print_r($e->getTraceAsString(), true)."\n";`	141	`$retour .= 'Contexte : '."\n".print_r($e->getTraceAsString(), true)."\n";`
148	`}`	142	`}`
149	`break;`	143	`break;`
150	`default:`	144	`default:`
151	`$retour .= '<pre class="debogage">'."\n";`	145	`$retour .= '<pre class="debogage">'."\n";`
152	`$retour .= $e->getMessage()."\n";`	146	`$retour .= $e->getMessage()."\n";`
153	`$retour .= '<span class="debogage_fichier">'.'Fichier : '.$e->getFile().'</span>'."\n";`	147	`$retour .= '<span class="debogage_fichier">'.'Fichier : '.$e->getFile().'</span>'."\n";`
154	`$retour .= '<span class="debogage_ligne">'.'Ligne : '.$e->getLine().'</span>'."\n";`	148	`$retour .= '<span class="debogage_ligne">'.'Ligne : '.$e->getLine().'</span>'."\n";`
155	`$retour .= '</pre>'."\n";`	149	`$retour .= '</pre>'."\n";`
156		150
157	`if (self::getContexte()) {`	151	`if (self::getContexte()) {`
158	`$retour .= '<pre>'."\n";`	152	`$retour .= '<pre>'."\n";`
159	`$retour .= '<strong>Contexte : </strong>'."\n".print_r($e->getTraceAsString(), true)."\n";`	153	`$retour .= '<strong>Contexte : </strong>'."\n".print_r($e->getTraceAsString(), true)."\n";`
160	`$retour .= '</pre>'."\n";`	154	`$retour .= '</pre>'."\n";`
161	`}`	155	`}`
162	`}`	156	`}`
163	`}`	157	`}`
164	`return $retour;`	158	`return $retour;`
165	`}`	159	`}`
166		160
167	`/**`	161	`/**`
168	`* logge une exception donnée sous une forme lisible`	162	`* logge une exception donnée sous une forme lisible`
169	`* @param Exception $e l'exception à logger`	163	`* @param Exception $e l'exception à logger`
170	`*/`	164	`*/`
171	`private static function loggerException($e) {`	165	`private static function loggerException($e) {`
172		166
173	`$erreur = '';`	167	`$erreur = '';`
174	`$erreur .= $e->getMessage()."\n";`	168	`$erreur .= $e->getMessage()."\n";`
175	`$erreur .= 'Fichier : '.$e->getFile()."\n";`	169	`$erreur .= 'Fichier : '.$e->getFile()."\n";`
176	`$erreur .= 'Ligne : '.$e->getLine()."\n";`	170	`$erreur .= 'Ligne : '.$e->getLine()."\n";`
177	`if (self::getContexte()) {`	171	`if (self::getContexte()) {`
178	`$erreur .= 'Contexte : '."\n".print_r($e->getTraceAsString(), true)."\n";`	172	`$erreur .= 'Contexte : '."\n".print_r($e->getTraceAsString(), true)."\n";`
179	`}`	173	`}`
180	`$erreur .= "\n";`	174	`$erreur .= "\n";`
181	`Log::ajouterEntree('erreurs',$erreur);`	175	`Log::ajouterEntree('erreurs',$erreur);`
182	`}`	176	`}`
-		177
-		178	`public function __destruct() {`
-		179	`echo self::getExceptions();`
-		180	`}`
183		181
184	`}`	182	`}`
185	`?>`	183	`?>`