Subversion Repositories Applications.gtt

Rev

Rev 49 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
10 jpm 1
<?php
48 jpm 2
/*vim: set expandtab tabstop=4 shiftwidth=4: */
10 jpm 3
// +------------------------------------------------------------------------------------------------------+
4
// | PHP version 5.0.4                                                                                    |
5
// +------------------------------------------------------------------------------------------------------+
6
// | Copyright (C) 2005 Tela Botanica (accueil@tela-botanica.org)                                         |
7
// +------------------------------------------------------------------------------------------------------+
8
// | This file is part of eFlore-Debogage.                                                                |
9
// |                                                                                                      |
10
// | Foobar is free software; you can redistribute it and/or modify                                       |
11
// | it under the terms of the GNU General Public License as published by                                 |
12
// | the Free Software Foundation; either version 2 of the License, or                                    |
13
// | (at your option) any later version.                                                                  |
14
// |                                                                                                      |
15
// | Foobar is distributed in the hope that it will be useful,                                            |
16
// | but WITHOUT ANY WARRANTY; without even the implied warranty of                                       |
17
// | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the                                        |
18
// | GNU General Public License for more details.                                                         |
19
// |                                                                                                      |
20
// | You should have received a copy of the GNU General Public License                                    |
21
// | along with Foobar; if not, write to the Free Software                                                |
22
// | Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA                            |
23
// +------------------------------------------------------------------------------------------------------+
24
// CVS : $Id: GestionnaireErreur.class.php,v 1.1 2005/11/15 17:33:49 jp_milcent Exp $
25
/**
26
* Classe de gestion des erreurs.
27
*
28
*
48 jpm 29
*
10 jpm 30
*@package eFlore
31
*@subpackage Debogage
32
//Auteur original :
33
*@author        Jean-Pascal MILCENT <jpm@tela-botanica.org>
34
//Autres auteurs :
35
*@author        aucun
36
*@copyright     Tela-Botanica 2000-2005
37
*@version       $Revision: 1.1 $ $Date: 2005/11/15 17:33:49 $
38
// +------------------------------------------------------------------------------------------------------+
39
*/
40
 
41
// +------------------------------------------------------------------------------------------------------+
42
// |                                            ENTETE du PROGRAMME                                       |
43
// +------------------------------------------------------------------------------------------------------+
44
 
45
 
46
// +------------------------------------------------------------------------------------------------------+
47
// |                                            CORPS du PROGRAMME                                        |
48
// +------------------------------------------------------------------------------------------------------+
49
 
50
 
51
/**
52
 * Classe GestionnaireErreur
48 jpm 53
 *
10 jpm 54
 * Gérer les erreurs PHP et SQL.
55
 */
48 jpm 56
class GestionnaireErreur {
10 jpm 57
	/*** Attributes: ***/
58
 
59
	/**
48 jpm 60
	* Contient la liste des erreurs.
61
	* @access private
62
	*/
10 jpm 63
	private $erreurs;
64
 
65
	/**
48 jpm 66
	* Permet de savoir si on veut faire apparaître ou pas le contexte de l'erreur,
67
	* c'est à dire le contenu des variables.
68
	* @access private
69
	*/
10 jpm 70
	private $contexte;
48 jpm 71
 
10 jpm 72
	/**
48 jpm 73
	* Permet de savoir si on veut faire apparaître ou pas les erreurs Pear.
74
	* @access private
75
	*/
76
	private $pear;
77
 
78
	/**
79
	* Chaine de caractères permettant d'identifier les erreurs de la bibliothèque Pear.
80
	* @access private
81
	*/
82
	private $pear_chaine;
83
 
84
	/**
85
	* Contient le niveau d'erreur courrant. Celui que l'on donne à la fonction
86
	* error_reporting().
87
	* @access private
88
	*/
10 jpm 89
	private $niveau_erreur_courrant;
48 jpm 90
 
10 jpm 91
	/*** Constructeur: ***/
48 jpm 92
 
10 jpm 93
	/**
48 jpm 94
	* Construit le gestionnaire d'erreur.
95
	*
96
	* @return void
97
	* @access public
98
	*/
99
	public function __construct($bool_contexte = false, $int_niveau = 2048, $bool_pear = false, $str_pear = '')
100
	{
10 jpm 101
		$this->erreurs = array();
48 jpm 102
		$this->setContexte($bool_contexte);
103
		$this->setNiveauErreurCourrant($int_niveau);
104
		$this->setPear($bool_pear);
105
		$this->setPearChaine($str_pear);
10 jpm 106
		set_error_handler(array($this, 'gererErreur'));
107
	} // end of member function __construct
48 jpm 108
 
109
 
10 jpm 110
	/*** Destructeur: ***/
111
	public function __destruct()
112
	{
113
		echo $this->retournerErreur();
114
	}
48 jpm 115
 
10 jpm 116
	/*** Accesseurs: ***/
48 jpm 117
 
10 jpm 118
	/**
48 jpm 119
	* Récupère le tableau des erreurs.
120
	*
121
	* @return array
122
	* @access public
123
	*/
124
	public function getErreur()
125
	{
10 jpm 126
		return $this->erreurs;
127
	}
128
 
129
	/**
48 jpm 130
	* Ajoute une erreur à la liste.
131
	*
132
	* @param array une_erreur
133
	* @return void
134
	* @access public
135
	*/
136
	public function setErreur($une_erreur)
137
	{
49 jpm 138
		$this->erreurs[] = $une_erreur;
10 jpm 139
	}
140
 
141
	/**
48 jpm 142
	* Récupère la valeur du contexte.
143
	*
144
	* @return boolean
145
	* @access public
146
	*/
147
	public function getContexte()
148
	{
10 jpm 149
		return $this->contexte;
150
	}
151
 
152
	/**
48 jpm 153
	* Définit si oui ou non le contexte sera affiché.
154
	*
155
	* @param boolean un_contexte
156
	* @return  void
157
	* @access public
158
	*/
159
	public function setContexte( $un_contexte )
160
	{
10 jpm 161
		$this->contexte = $un_contexte;
162
	}
48 jpm 163
 
10 jpm 164
	/**
48 jpm 165
	* Récupère la valeur de l'attribut Pear.
166
	*
167
	* @return boolean true pour afficher les erreurs Pear sinon false.
168
	* @access public
169
	*/
170
	public function getPear()
171
	{
172
		return $this->pear;
173
	}
174
 
175
	/**
176
	* Définit si oui ou non les erreurs Pear seront affichées.
177
	*
178
	* @param boolean true pour afficher les erreurs Pear sinon false.
179
	* @return  void
180
	* @access public
181
	*/
182
	public function setPear( $p )
183
	{
184
		$this->pear = $p;
185
	}
186
 
187
	/**
188
	* Récupère la valeur de l'attribut pear_chaine.
189
	*
190
	* @return string la chaine de caractère identifiant les erreurs Pear.
191
	* @access public
192
	*/
193
	public function getPearChaine()
194
	{
195
		return $this->pear_chaine;
196
	}
197
 
198
	/**
199
	* Définit la chaine de caractère identifiant les erreurs Pear.
200
	*
201
	* @param string la chaine de caractère identifiant les erreurs Pear.
202
	* @return  void
203
	* @access public
204
	*/
205
	public function setPearChaine( $pc )
206
	{
207
		$this->pear_chaine = $pc;
208
	}
209
 
210
 
211
	/**
212
	* Récupère le niveau d'erreur courrant.
213
	*
214
	* @return int le niveau d'erreur courrant.
215
	* @access public
216
	*/
217
	public function getNiveauErreurCourrant()
218
	{
10 jpm 219
		return (int)$this->niveau_erreur_courrant;
220
	}
221
 
222
	/**
48 jpm 223
	* Définit le niveau d'erreur courrant.
224
	*
225
	* @param int un niveau d'erreur.
226
	* @return void
227
	* @access public
228
	*/
229
	public function setNiveauErreurCourrant($niveau)
230
	{
10 jpm 231
		$this->niveau_erreur_courrant = $niveau;
232
	}
48 jpm 233
 
10 jpm 234
	/*** Méthodes : ***/
48 jpm 235
 
10 jpm 236
	/**
48 jpm 237
	*
238
	* @param int niveau
239
	* @param string message
240
	* @param string fichier
241
	* @param int ligne
242
	* @param boolean contexte
243
	* @return void
244
	* @access public
245
	*/
246
	public function gererErreur( $niveau,  $message,  $fichier,  $ligne,  $contexte )
247
	{
10 jpm 248
		$aso_erreur = array();
249
		// Nous vérifions si nous affichons ou pas l'erreur en fonction du niveau demandé
250
		if ( $niveau <= $this->getNiveauErreurCourrant() ) {
251
			$aso_erreur['niveau'] = $niveau;
252
			$aso_erreur['message'] = $message;
253
			$aso_erreur['fichier'] = $fichier;
254
			$aso_erreur['ligne'] = $ligne;
255
			if ($this->getContexte()) {
256
				$aso_erreur['contexte'] = $contexte;
257
			}
258
			$this->setErreur($aso_erreur);
259
		}
48 jpm 260
 
10 jpm 261
		// Si nous avons à faire à une erreur et non à un warning ou une notice, nous arrêtons l'exécution du script
262
		if ($niveau == E_USER_ERROR) {
263
			echo 	$this->retournerErreur();
264
			exit(1);
265
		}
266
	} // end of member function gererErreur
267
 
268
	/**
269
	 * Retourne l'erreur PHP formatée en XHTML.
270
	 *
271
	 * @return string
272
	 * @access public
273
	 */
48 jpm 274
	public function retournerErreur()
275
	{
10 jpm 276
		$retour = '';
48 jpm 277
		$erreur_pear_nbre = 0;
10 jpm 278
		foreach($this->getErreur() as $aso_erreur) {
279
			if ('<!-- BEGIN sql -->' == substr($aso_erreur['message'], 0, 18)) {
280
				$retour .= $aso_erreur['message'];
281
				continue;
282
			}
48 jpm 283
			// Nous testons les erreurs PEAR pour ne pas en tenir compte
284
			if (!$this->getPear() && stristr($aso_erreur['fichier'], $this->getPearChaine())) {
285
				$erreur_pear_nbre++;
286
			} else {
287
				$retour .= '<p class="attention">'."\n";
288
				$retour .= '<strong>ERREUR</strong><br />'."\n";
289
				$retour .= '<strong>Niveau : </strong>'.$aso_erreur['niveau'].'<br />'."\n";
290
				$retour .= '<strong>Message : </strong>'.$aso_erreur['message'].'<br />'."\n";
291
				$retour .= '<strong>Fichier : </strong>'.$aso_erreur['fichier'].'<br />'."\n";
292
				$retour .= '<strong>Ligne : </strong>'.$aso_erreur['ligne'].'<br />'."\n";
293
				if ($this->getContexte()) {
294
					$retour .= '<pre>'."\n";
295
					$retour .= '<stong>Contexte : </stong>'."\n".print_r($aso_erreur['contexte'], true)."\n";
296
					$retour .= '</pre>'."\n";
297
				}
298
				$retour .= '</p>'."\n";
299
			}
10 jpm 300
		}
48 jpm 301
		if ($erreur_pear_nbre != 0) {
302
			$retour .= '<p class="attention"><strong>Nombre d\'erreurs PEAR : </strong>'.$erreur_pear_nbre.'</p>'."\n";
303
		}
10 jpm 304
		return $retour;
305
	} // end of member function retournerErreur
306
 
307
	/**
48 jpm 308
	* Retourne l'erreur SQL formatée.
309
	*
310
	* @param string fichier
311
	* @param int ligne
312
	* @param string message
313
	* @param string requete
314
	* @param string autres
315
	* @return string
316
	* @static
317
	* @access public
318
	*/
319
	public static function retournerErreurSql( $fichier,  $methode,  $message,  $requete = NULL,  $autres = NULL )
320
	{
10 jpm 321
		$retour = '<!-- BEGIN sql -->';
322
		$retour .= '<div id="zone_erreur">'."\n";
323
		$retour .= '<h1 > ERREUR SQL </h1><br />'."\n";
324
		$retour .= '<dl>'."\n";
325
		$retour .= '<dt> Fichier : </dt> ';
326
		$retour .= '<dd> '.$fichier.'</dd>'."\n";
48 jpm 327
 
10 jpm 328
		$retour .= '<dt> Méthode : </dt> ';
329
		$retour .= '<dd> '.$methode.'</dd>'."\n";
48 jpm 330
 
10 jpm 331
		$retour .= '<dt> Message erreur : </dt> ';
332
		$retour .= '<dd> '.$message.'</dd>'."\n";
48 jpm 333
 
10 jpm 334
		if (!is_null($requete)) {
335
			$retour .= '<dt> Requete : </dt> ';
336
			$retour .= '<dd> '.$requete.' </dd>'."\n";
337
    	}
48 jpm 338
 
10 jpm 339
		if (!is_null($autres)) {
340
			$retour .= '<dt> Autres infos : </dt> ';
341
			$retour .= '<dd> '.$autres.' </dd>'."\n";
342
		}
343
		$retour .= '</dl>'."\n";
344
		$retour .= '</div>'."\n";
345
		$retour .= '<!-- END sql -->'."\n";
48 jpm 346
 
10 jpm 347
		return $retour;
348
	} // end of member function retournerErreurSql
48 jpm 349
 
10 jpm 350
	/**
48 jpm 351
	* Retourne l'erreur SQL formatée selon le format demandé.
352
	*
353
	* @param string fichier
354
	* @param int ligne
355
	* @param string message
356
	* @param string format : txt.
357
	* @return string
358
	* @static
359
	* @access public
360
	*/
10 jpm 361
	public static function formaterMessageErreur( $message, $fichier = null,  $ligne = null,  $format = 'txt' )
362
	{
363
		$retour = '';
364
		if ($format == 'txt') {
365
			$retour .= "\n";
366
			if (!is_null($fichier)) {
367
				$retour .= "\t".'Fichier : '.$fichier."\n";
368
			}
369
			if (!is_null($ligne)) {
370
				$retour .= "\t".'Ligne : '.$ligne."\n";
371
			}
372
			$retour .= "\t".'Message : '.$message."\n";
373
		}
374
		return $retour;
375
	}
48 jpm 376
}
10 jpm 377
 
378
/* +--Fin du code ----------------------------------------------------------------------------------------+
379
*
48 jpm 380
* $Log$
10 jpm 381
*
382
* +-- Fin du code ----------------------------------------------------------------------------------------+
383
*/
384
?>