WebSVN – Applications.framework – Diff – /trunk/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 124 2009-09-01 15:58: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::$mode = 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::$mode;
	}
 
	/**
	 * 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::$mode = $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
	 */
	public static function gererException(Exception $e) {
 
		// pour le moment on se contente de l'ajouter au tableau et de les afficher
		self::$exceptions[] = $e;
 
        if(self::$logger) {
        	self::loggerException($e);
        }
 
		if($e->getCode() != 0 && $e->getCode() <= error_reporting()) {
			echo self::getExceptions();
			return;
		}
	}
 
	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";
					$retour .= 'Message : '.$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;
	}
 
    private static function loggerException($e) {
 
        $erreur = '';
 
        $erreur .= 'Fichier : '.$e->getFile()."\n";
        $erreur .= 'Ligne : '.$e->getLine()."\n";
        $erreur .= 'Message : '.$e->getMessage()."\n";
 
 
        if (self::getContexte()) {
            $erreur .= 'Contexte : '."\n".print_r($e->getTraceAsString(), true)."\n";
        }
        $erreur .= "\n";
 
        Log::ajouterEntree('erreurs',$erreur);
    }
 
}
?>

Subversion Repositories Applications.framework

(root)/trunk/framework/GestionnaireException.php – Rev 122 → 124

Rev 122		Rev 124
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 122 2009-09-01 15:00:35Z aurelien $$`	14	`* @version SVN: $$Id: GestionnaireException.php 124 2009-09-01 15:58: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::$mode = Config::get('fw_debogage_contexte');`	52	`self::$mode = 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::$mode;`	64	`return self::$mode;`
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::$mode = $contexte;`	72	`self::$mode = $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	`*/`	89	`*/`
90	`public static function gererException(Exception $e) {`	90	`public static function gererException(Exception $e) {`
91		91
92	`// pour le moment on se contente de l'ajouter au tableau et de les afficher`	92	`// pour le moment on se contente de l'ajouter au tableau et de les afficher`
93	`self::$exceptions[] = $e;`	93	`self::$exceptions[] = $e;`
94		94
95	`if(self::$logger) {`	95	`if(self::$logger) {`
96	`self::loggerException($e);`	96	`self::loggerException($e);`
97	`}`	97	`}`
98		98
99	`if($e->getCode() != 0 && $e->getCode() <= error_reporting()) {`	99	`if($e->getCode() != 0 && $e->getCode() <= error_reporting()) {`
100	`echo self::getExceptions();`	100	`echo self::getExceptions();`
101	`return;`	101	`return;`
102	`}`	102	`}`
103	`}`	103	`}`
104		104
105	`public static function gererErreur($niveau, $message, $fichier, $ligne, $contexte){`	105	`public static function gererErreur($niveau, $message, $fichier, $ligne, $contexte){`
106	`// si aucun rapport d'erreur, on sort directement`	106	`// si aucun rapport d'erreur, on sort directement`
107	`if (error_reporting() == 0)`	107	`if (error_reporting() == 0)`
108	`{`	108	`{`
109	`return;`	109	`return;`
110	`}`	110	`}`
111		111
112	`// sinon on crée une exception`	112	`// sinon on crée une exception`
113	`$e = new ErrorException($message, 0, $niveau, $fichier, $ligne);`	113	`$e = new ErrorException($message, 0, $niveau, $fichier, $ligne);`
114	`// que l'on donne au tableau d'exceptions`	114	`// que l'on donne au tableau d'exceptions`
115	`self::$exceptions[] = $e;`	115	`self::$exceptions[] = $e;`
116	`// on la logge si nécéssaire`	116	`// on la logge si nécéssaire`
117	`if(self::$logger) {`	117	`if(self::$logger) {`
118	`self::loggerException($e);`	118	`self::loggerException($e);`
119	`}`	119	`}`
120	`return;`	120	`return;`
121	`}`	121	`}`
122		122
123	`/**`	123	`/**`
124	`* Renvoie les exceptions au format (X)HTML`	124	`* Renvoie les exceptions au format (X)HTML`
125	`* ou bien au format texte suivant le mode d'utilisation de PHP`	125	`* ou bien au format texte suivant le mode d'utilisation de PHP`
126	`*/`	126	`*/`
127	`public static function getExceptions() {`	127	`public static function getExceptions() {`
128	`$retour = '';`	128	`$retour = '';`
129	`foreach (self::$exceptions as $e) {`	129	`foreach (self::$exceptions as $e) {`
130	`switch(self::$mode) {`	130	`switch(self::$mode) {`
131	`case 'cli' :`	131	`case 'cli' :`
132	`$retour .= $e->getMessage()."\n";`	132	`$retour .= $e->getMessage()."\n";`
133	`$retour .= 'Fichier : '.$e->getFile()."\n";`	133	`$retour .= 'Fichier : '.$e->getFile()."\n";`
134	`$retour .= 'Ligne : '.$e->getLine()."\n";`	134	`$retour .= 'Ligne : '.$e->getLine()."\n";`
135	`$retour .= 'Message : '.$e->getMessage()."\n";`	135	`$retour .= 'Message : '.$e->getMessage()."\n";`
136	`$retour .= 'Fichier : '.$e->getFile()."\n";`	136	`$retour .= 'Fichier : '.$e->getFile()."\n";`
137	`$retour .= 'Ligne : '.$e->getLine()."\n";`	137	`$retour .= 'Ligne : '.$e->getLine()."\n";`
138	`if (self::getContexte()) {`	138	`if (self::getContexte()) {`
139	`$retour .= 'Contexte : '."\n".print_r($e->getTraceAsString(), true)."\n";`	139	`$retour .= 'Contexte : '."\n".print_r($e->getTraceAsString(), true)."\n";`
140	`}`	140	`}`
141	`break;`	141	`break;`
142	`default:`	142	`default:`
143	`$retour .= '<pre class="debogage">'."\n";`	143	`$retour .= '<pre class="debogage">'."\n";`
144	`$retour .= htmlentities($e->getMessage())."\n";`	144	`$retour .= $e->getMessage()."\n";`
145	`$retour .= '<span class="debogage_fichier">'.'Fichier : '.$e->getFile().'</span>'."\n";`	145	`$retour .= '<span class="debogage_fichier">'.'Fichier : '.$e->getFile().'</span>'."\n";`
146	`$retour .= '<span class="debogage_ligne">'.'Ligne : '.$e->getLine().'</span>'."\n";`	146	`$retour .= '<span class="debogage_ligne">'.'Ligne : '.$e->getLine().'</span>'."\n";`
147	`$retour .= '</pre>'."\n";`	147	`$retour .= '</pre>'."\n";`
148		148
149	`if (self::getContexte()) {`	149	`if (self::getContexte()) {`
150	`$retour .= '<pre>'."\n";`	150	`$retour .= '<pre>'."\n";`
151	`$retour .= '<strong>Contexte : </strong>'."\n".print_r($e->getTraceAsString(), true)."\n";`	151	`$retour .= '<strong>Contexte : </strong>'."\n".print_r($e->getTraceAsString(), true)."\n";`
152	`$retour .= '</pre>'."\n";`	152	`$retour .= '</pre>'."\n";`
153	`}`	153	`}`
154	`}`	154	`}`
155	`}`	155	`}`
156	`return $retour;`	156	`return $retour;`
157	`}`	157	`}`
158		158
159	`private static function loggerException($e) {`	159	`private static function loggerException($e) {`
160		160
161	`$erreur = '';`	161	`$erreur = '';`
162	`$erreur .= $e->getMessage()."\n";`	-
163	`$erreur .= 'Fichier : '.$e->getFile()."\n";`	162	`$erreur .= 'Fichier : '.$e->getFile()."\n";`
164	`$erreur .= 'Ligne : '.$e->getLine()."\n";`	163	`$erreur .= 'Ligne : '.$e->getLine()."\n";`
165	`$erreur .= 'Message : '.$e->getMessage()."\n";`	164	`$erreur .= 'Message : '.$e->getMessage()."\n";`
166	`$erreur .= 'Fichier : '.$e->getFile()."\n";`	-
167	`$erreur .= 'Ligne : '.$e->getLine()."\n";`	-
168	`if (self::getContexte()) {`	165	`if (self::getContexte()) {`
169	`$erreur .= 'Contexte : '."\n".print_r($e->getTraceAsString(), true)."\n";`	166	`$erreur .= 'Contexte : '."\n".print_r($e->getTraceAsString(), true)."\n";`
170	`}`	167	`}`
171	`$erreur .= "\n";`	168	`$erreur .= "\n";`
172		169
173	`Log::ajouterEntree('erreurs',$erreur);`	170	`Log::ajouterEntree('erreurs',$erreur);`
174	`}`	171	`}`
175		172
176	`}`	173	`}`
177	`?>`	174	`?>`