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 115 2009-09-01 09:02:25Z jp_milcent $$ 
* @link      /doc/framework/ 
* 
*/
class GestionnaireException {
	
	/**
	 * Liste des exceptions enregistrées
	 */
	private static $exceptions;
	
	/**
	 * Détermine si l'on affiche ou nom le contexte
	 */
	private $contexte;
	
	/**
	 * Definit si php est lancé en ligne de commande ou en mode serveur
	 */
	private $mode;		
	
	/**
	 * 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($contexte = false) {
		self::$exceptions = array();
		$this->contexte = $contexte;
		$this->mode = php_sapi_name();
		set_exception_handler(array($this,'gererException'));
	}
	
	/**
	 * Renvoie le booleen définissant si l'on affiche le contexte ou non
	 */
	public function getContexte() {
		return $this->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) {
		$this->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
	 */
	public static function gererException(Exception $e) {
 
		// pour le moment on se contente de l'ajouter au tableau
		self::$exceptions[] = $e;	
	}
	
	/**
	 * Renvoie les exceptions au format (X)HTML
	 * ou bien au format texte suivant le mode d'utilisation de PHP
	 */
	public function getExceptions() {
		$retour = '';
		foreach (self::$exceptions as $e) { 
			switch($this->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 ($this->getContexte()) {
						$retour .= 'Contexte : '."\n".print_r($e->getTraceAsString(), true)."\n";
					}
					break;
				default:
					$retour .= '<pre class="debogage">'."\n";
					$retour .= htmlentities($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 ($this->getContexte()) {
						$retour .= '<pre>'."\n";
						$retour .= '<strong>Contexte : </strong>'."\n".print_r($e->getTraceAsString(), true)."\n";
						$retour .= '</pre>'."\n";
					}
			}
		}
		return $retour;
	}
 
}  
?>

Rev 114	Rev 115
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 114 2009-09-01 08:46:56Z jp_milcent $$`	14	`* @version SVN: $$Id: GestionnaireException.php 115 2009-09-01 09:02:25Z jp_milcent $$`
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 $exceptions;`	23	`private static $exceptions;`
24		24
25	`/**`	25	`/**`
26	`* Détermine si l'on affiche ou nom le contexte`	26	`* Détermine si l'on affiche ou nom le contexte`
27	`*/`	27	`*/`
28	`private $contexte;`	28	`private $contexte;`
29		29
30	`/**`	30	`/**`
31	`* Definit si php est lancé en ligne de commande ou en mode serveur`	31	`* Definit si php est lancé en ligne de commande ou en mode serveur`
32	`*/`	32	`*/`
33	`private $mode;`	33	`private $mode;`
34		34
35	`/**`	35	`/**`
36	`* le gestionnaire d'exception est un singleton`	36	`* le gestionnaire d'exception est un singleton`
37	`* et possède donc un "pointeur statique sur lui-même"`	37	`* et possède donc un "pointeur statique sur lui-même"`
38	`*/`	38	`*/`
39	`private static $gestionnaireException ;`	39	`private static $gestionnaireException;`
40		40
41	`/**`	41	`/**`
42	`* Constructeur avec paramètres optionnel`	42	`* Constructeur avec paramètres optionnel`
43	`* @param bool indique si l'on veut afficher ou non le contexte des exceptions (i.e. la trace)`	43	`* @param bool indique si l'on veut afficher ou non le contexte des exceptions (i.e. la trace)`
44	`*/`	44	`*/`
45	`public function __construct($contexte = false) {`	45	`public function __construct($contexte = false) {`
46	`$this->exceptions = array();`	46	`self::$exceptions = array();`
47	`$this->contexte = $contexte;`	47	`$this->contexte = $contexte;`
48	`$this->mode = php_sapi_name();`	48	`$this->mode = php_sapi_name();`
49	`set_exception_handler(array($this,'gererException'));`	49	`set_exception_handler(array($this,'gererException'));`
50	`}`	50	`}`
51		51
52	`/**`	52	`/**`
53	`* Renvoie le booleen définissant si l'on affiche le contexte ou non`	53	`* Renvoie le booleen définissant si l'on affiche le contexte ou non`
54	`*/`	54	`*/`
55	`public function getContexte() {`	55	`public function getContexte() {`
56	`return $this->contexte;`	56	`return $this->contexte;`
57	`}`	57	`}`
58		58
59	`/**`	59	`/**`
60	`* Definit si l'on veut afficher le contexte ou non`	60	`* Definit si l'on veut afficher le contexte ou non`
61	`* @param bool true si on veut afficher le contexte, false sinon, par défaut vaut false`	61	`* @param bool true si on veut afficher le contexte, false sinon, par défaut vaut false`
62	`*/`	62	`*/`
63	`public function setContexte($contexte) {`	63	`public function setContexte($contexte) {`
64	`$this->contexte = $contexte;`	64	`$this->contexte = $contexte;`
65	`}`	65	`}`
66		66
67	`/** Fonction d'accès au singleton`	67	`/** Fonction d'accès au singleton`
68	`* @return GestionnaireErreur le gestionnaire d'exceptions courant`	68	`* @return GestionnaireErreur le gestionnaire d'exceptions courant`
69	`*/`	69	`*/`
70	`public static function getInstance() {`	70	`public static function getInstance() {`
71	`if (self::$gestionnaireException instanceof GestionnaireException) {`	71	`if (self::$gestionnaireException instanceof GestionnaireException) {`
72	`return self::$gestionnaireException;`	72	`return self::$gestionnaireException;`
73	`}`	73	`}`
74	`self::$gestionnaireException = new GestionnaireException;`	74	`self::$gestionnaireException = new GestionnaireException;`
75	`return self::$gestionnaireException;`	75	`return self::$gestionnaireException;`
76	`}`	76	`}`
77		77
78	`/**`	78	`/**`
79	`* Fonction de gestion des exceptions, remplace le handler par défaut`	79	`* Fonction de gestion des exceptions, remplace le handler par défaut`
80	`*/`	80	`*/`
81	`public static function gererException(Exception $e) {`	81	`public static function gererException(Exception $e) {`
82		-
83	`// pour le moment on se contente de l'ajouter au tableau`	82	`// pour le moment on se contente de l'ajouter au tableau`
84	`$this->exceptions[] = $e;`	83	`self::$exceptions[] = $e;`
85	`}`	84	`}`
86		85
87	`/**`	86	`/**`
88	`* Renvoie les exceptions au format (X)HTML`	87	`* Renvoie les exceptions au format (X)HTML`
89	`* ou bien au format texte suivant le mode d'utilisation de PHP`	88	`* ou bien au format texte suivant le mode d'utilisation de PHP`
90	`*/`	89	`*/`
91	`public function getExceptions() {`	90	`public function getExceptions() {`
92	`$retour = '';`	91	`$retour = '';`
93	`foreach ($this->exceptions as $e) {`	92	`foreach (self::$exceptions as $e) {`
94	`switch($this->mode) {`	93	`switch($this->mode) {`
95	`case 'cli' :`	94	`case 'cli' :`
96	`$retour .= $e->getMessage()."\n";`	95	`$retour .= $e->getMessage()."\n";`
97	`$retour .= 'Fichier : '.$e->getFile()."\n";`	96	`$retour .= 'Fichier : '.$e->getFile()."\n";`
98	`$retour .= 'Ligne : '.$e->getLine()."\n";`	97	`$retour .= 'Ligne : '.$e->getLine()."\n";`
99	`$retour .= 'Message : '.$e->getMessage()."\n";`	98	`$retour .= 'Message : '.$e->getMessage()."\n";`
100	`$retour .= 'Fichier : '.$e->getFile()."\n";`	99	`$retour .= 'Fichier : '.$e->getFile()."\n";`
101	`$retour .= 'Ligne : '.$e->getLine()."\n";`	100	`$retour .= 'Ligne : '.$e->getLine()."\n";`
102	`if ($this->getContexte()) {`	101	`if ($this->getContexte()) {`
103	`$retour .= 'Contexte : '."\n".print_r($e->getTraceAsString(), true)."\n";`	102	`$retour .= 'Contexte : '."\n".print_r($e->getTraceAsString(), true)."\n";`
104	`}`	103	`}`
105	`break;`	104	`break;`
106	`default:`	105	`default:`
107	`$retour .= '<pre class="debogage">'."\n";`	106	`$retour .= '<pre class="debogage">'."\n";`
108	`$retour .= htmlentities($e->getMessage())."\n";`	107	`$retour .= htmlentities($e->getMessage())."\n";`
109	`$retour .= '<span class="debogage_fichier">'.'Fichier : '.$e->getFile().'</span>'."\n";`	108	`$retour .= '<span class="debogage_fichier">'.'Fichier : '.$e->getFile().'</span>'."\n";`
110	`$retour .= '<span class="debogage_ligne">'.'Ligne : '.$e->getLine().'</span>'."\n";`	109	`$retour .= '<span class="debogage_ligne">'.'Ligne : '.$e->getLine().'</span>'."\n";`
111	`$retour .= '</pre>'."\n";`	110	`$retour .= '</pre>'."\n";`
112		111
113	`if ($this->getContexte()) {`	112	`if ($this->getContexte()) {`
114	`$retour .= '<pre>'."\n";`	113	`$retour .= '<pre>'."\n";`
115	`$retour .= '<strong>Contexte : </strong>'."\n".print_r($e->getTraceAsString(), true)."\n";`	114	`$retour .= '<strong>Contexte : </strong>'."\n".print_r($e->getTraceAsString(), true)."\n";`
116	`$retour .= '</pre>'."\n";`	115	`$retour .= '</pre>'."\n";`
117	`}`	116	`}`
118	`}`	117	`}`
119	`}`	118	`}`
120	`return $retour;`	119	`return $retour;`
121	`}`	120	`}`
122		121
123	`}`	122	`}`
124	`?>`	123	`?>`

Subversion Repositories Applications.framework

(root)/trunk/framework/GestionnaireException.php @ 212 – Rev 114 → 115