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 114 2009-09-01 08:46:56Z jp_milcent $$ 
* @link      /doc/framework/ 
* 
*/
class GestionnaireException {
	
	/**
	 * Liste des exceptions enregistrées
	 */
	private $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) {
 
		$this->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
		$this->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 ($this->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;
	}
 
}  
?>

Subversion Repositories Applications.framework

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

Rev 105		Rev 114
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 105 2009-08-31 15:25:05Z aurelien $$`	14	`* @version SVN: $$Id: GestionnaireException.php 114 2009-09-01 08:46:56Z 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 $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		-
47	`$this->exceptions = array();`	46	`$this->exceptions = array();`
48	`$this->contexte = $contexte;`	47	`$this->contexte = $contexte;`
49	`$this->mode = php_sapi_name();`	48	`$this->mode = php_sapi_name();`
50	`set_exception_handler(array($this,'gererException'));`	49	`set_exception_handler(array($this,'gererException'));`
51	`}`	50	`}`
52		51
53	`/**`	52	`/**`
54	`* 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`
55	`*/`	54	`*/`
56	`public function getContexte() {`	55	`public function getContexte() {`
57	`return $this->contexte;`	56	`return $this->contexte;`
58	`}`	57	`}`
59		58
60	`/**`	59	`/**`
61	`* Definit si l'on veut afficher le contexte ou non`	60	`* Definit si l'on veut afficher le contexte ou non`
62	`* @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`
63	`*/`	62	`*/`
64	`public function setContexte($contexte) {`	63	`public function setContexte($contexte) {`
65	`$this->contexte = $contexte;`	64	`$this->contexte = $contexte;`
66	`}`	65	`}`
67		66
68	`/** Fonction d'accès au singleton`	67	`/** Fonction d'accès au singleton`
69	`* @return GestionnaireErreur le gestionnaire d'exceptions courant`	68	`* @return GestionnaireErreur le gestionnaire d'exceptions courant`
70	`*/`	69	`*/`
71	`public static function getInstance()`	70	`public static function getInstance() {`
72	`{`	-
73	`if (self::$gestionnaireException instanceof GestionnaireException) {`	71	`if (self::$gestionnaireException instanceof GestionnaireException) {`
74	`return self::$gestionnaireException;`	72	`return self::$gestionnaireException;`
75	`}`	73	`}`
76	`self::$gestionnaireException = new GestionnaireException;`	74	`self::$gestionnaireException = new GestionnaireException;`
77	`return self::$gestionnaireException;`	75	`return self::$gestionnaireException;`
78	`}`	76	`}`
79		77
80	`/**`	78	`/**`
81	`* Fonction de gestion des exceptions, remplace le handler par défaut`	79	`* Fonction de gestion des exceptions, remplace le handler par défaut`
82	`*/`	80	`*/`
83	`public static function gererException(Exception $e) {`	81	`public static function gererException(Exception $e) {`
84		82
85	`// pour le moment on se contente de l'ajouter au tableau`	83	`// pour le moment on se contente de l'ajouter au tableau`
86	`$this->exceptions[] = $e;`	84	`$this->exceptions[] = $e;`
87	`}`	85	`}`
88		86
89	`/**`	87	`/**`
90	`* Renvoie les exceptions au format (X)HTML`	88	`* Renvoie les exceptions au format (X)HTML`
91	`* ou bien au format texte suivant le mode d'utilisation de PHP`	89	`* ou bien au format texte suivant le mode d'utilisation de PHP`
92	`*/`	90	`*/`
93	`public function getExceptions() {`	91	`public function getExceptions() {`
94		92	`$retour = '';`
95	`foreach ($this->exceptions as $e) {`	93	`foreach ($this->exceptions as $e) {`
96	`switch($this->mode) {`	94	`switch($this->mode) {`
97	`case 'cli' :`	95	`case 'cli' :`
98	`$retour .= $e->getMessage()."\n";`	96	`$retour .= $e->getMessage()."\n";`
99	`$retour .= 'Fichier : '.$e->getFile()."\n";`	97	`$retour .= 'Fichier : '.$e->getFile()."\n";`
100	`$retour .= 'Ligne : '.$e->getLine()."\n";`	98	`$retour .= 'Ligne : '.$e->getLine()."\n";`
101	`$retour .= 'Message : '.$e->getMessage()."\n";`	99	`$retour .= 'Message : '.$e->getMessage()."\n";`
102	`$retour .= 'Fichier : '.$e->getFile()."\n";`	100	`$retour .= 'Fichier : '.$e->getFile()."\n";`
103	`$retour .= 'Ligne : '.$e->getLine()."\n";`	101	`$retour .= 'Ligne : '.$e->getLine()."\n";`
104	`if ($this->getContexte()) {`	102	`if ($this->getContexte()) {`
105	`$retour .= 'Contexte : '."\n".print_r($e->getTraceAsString(), true)."\n";`	103	`$retour .= 'Contexte : '."\n".print_r($e->getTraceAsString(), true)."\n";`
106	`}`	104	`}`
107	`break;`	105	`break;`
108	`default:`	106	`default:`
109	`$retour .= '<pre class="debogage">'."\n";`	107	`$retour .= '<pre class="debogage">'."\n";`
110	`$retour .= htmlentities($e->getMessage())."\n";`	108	`$retour .= htmlentities($e->getMessage())."\n";`
111	`$retour .= '<span class="debogage_fichier">'.'Fichier : '.$e->getFile().'</span>'."\n";`	109	`$retour .= '<span class="debogage_fichier">'.'Fichier : '.$e->getFile().'</span>'."\n";`
112	`$retour .= '<span class="debogage_ligne">'.'Ligne : '.$e->getLine().'</span>'."\n";`	110	`$retour .= '<span class="debogage_ligne">'.'Ligne : '.$e->getLine().'</span>'."\n";`
113	`$retour .= '</pre>'."\n";`	111	`$retour .= '</pre>'."\n";`
114		112
115	`if ($this->getContexte()) {`	113	`if ($this->getContexte()) {`
116	`$retour .= '<pre>'."\n";`	114	`$retour .= '<pre>'."\n";`
117	`$retour .= '<strong>Contexte : </strong>'."\n".print_r($e->getTraceAsString(), true)."\n";`	115	`$retour .= '<strong>Contexte : </strong>'."\n".print_r($e->getTraceAsString(), true)."\n";`
118	`$retour .= '</pre>'."\n";`	116	`$retour .= '</pre>'."\n";`
119	`}`	117	`}`
120	`}`	118	`}`
121	`}`	119	`}`
122	`return $retour;`	120	`return $retour;`
123	`}`	121	`}`
124		122
125	`}`	123	`}`
126	`?>`	124	`?>`