Subversion Repositories Applications.framework

Rev

Rev 97 | Rev 153 | Go to most recent revision | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 97 Rev 129
1 
<?php
 1 
<?php
2 
// declare(encoding='UTF-8');
 2 
// declare(encoding='UTF-8');
3 
/**
 3 
/**
4 
* Classe fournissant des fonctions de débogage équivalante à var_dump et print_r.
 4 
 * Classe fournissant des fonctions de débogage équivalante à var_dump et print_r.
5 
* L'affichage et l'utilisation de ces fonctions sont améliorés via cette classe.
 5 
 * L'affichage et l'utilisation de ces fonctions sont améliorés via cette classe.
6 
* Cette classe est inspirée de la classe Zend_Debug.
 6 
 * Cette classe est inspirée de la classe Zend_Debug.
7 
*
 7 
 *
8 
* @package Framework
 8 
 * PHP version 5
- 
 
 9 
 *
9 
* @category Debogage
 10 
 * @category Debogage
- 
 
 11 
 * @package Framework
10 
// Auteur principal :
 12 
 // Auteur principal :
11 
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
 13 
 * @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
12 
// Autres auteurs :
 14 
 // Autres auteurs :
13 
* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>
 15 
 * @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>
14 
* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
 16 
 * @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
15 
* @version $$Id$$
 17 
 * @version $$Id$$
16 
* @copyright 1999-2009 Tela Botanica (accueil@tela-botanica.org)
 18 
 * @copyright 1999-2009 Tela Botanica (accueil@tela-botanica.org)
17 
*/
 19 
 */
18 
class Debug {
 20 
class Debug {
- 
 
 21 
 
- 
 
 22 
	/**
- 
 
 23 
	 * mode de php (cli ou sapi)
19 
 
 24 
	 */
- 
 
 25 
	protected static $mode = null;
- 
 
 26 
 
- 
 
 27 
	/**
- 
 
 28 
	 * Accesseur pour le mode
20 
	protected static $mode = null;
 29 
	 * @return string le mode de php
21 
 
 30 
	 */
22 
	public static function getMode() {
 31 
	public static function getMode() {
23 
		if (self::$mode === null) {
 32 
		if (self::$mode === null) {
24 
			self::$mode = PHP_SAPI;
 33 
			self::$mode = PHP_SAPI;
25 
		}
 34 
		}
26 
		return self::$mode;
 35 
		return self::$mode;
27 
	}
 36 
	}
- 
 
 37 
 
- 
 
 38 
	/**
- 
 
 39 
	 * Equivalent de var_dump
- 
 
 40 
	 * @param mixed $variable la variable à dumper
- 
 
 41 
	 * @param string $mot_cle le mot cle à associer à la variable
- 
 
 42 
	 * @param boolean $echo si true on affiche le résultat, si false on ne renvoie que la chaine sans l'afficher
- 
 
 43 
	 * @return string la chaine à afficher representant le dump ou null si echo
28 
 
 44 
	 */
29 
	public static function dump($variable, $mot_cle = null, $echo = true) {
 45 
	public static function dump($variable, $mot_cle = null, $echo = true) {
30 
		// var_dump de la variable dans un buffer et récupération de la sortie
 46 
		// var_dump de la variable dans un buffer et récupération de la sortie
31 
		ob_start();
 47 
		ob_start();
32 
		var_dump($variable);
 48 
		var_dump($variable);
33 
		$sortie = ob_get_clean();
 49 
		$sortie = ob_get_clean();
34 
 
 50 
 
35 
		// Pré-traitement de la sortie
 51 
		// Pré-traitement de la sortie
36 
		$sortie = preg_replace("/\]\=\>\n(\s+)/m", "] => ", $sortie);
 52 
		$sortie = preg_replace("/\]\=\>\n(\s+)/m", "] => ", $sortie);
37 
 
 53 
 
38 
		// Traitement général du débogage
 54 
		// Traitement général du débogage
39 
		return self::traiterDebogage($mot_cle, $sortie, $echo);
 55 
		return self::traiterDebogage($mot_cle, $sortie, $echo);
40 
	}
 56 
	}
- 
 
 57 
 
- 
 
 58 
	/**
- 
 
 59 
	 * Equivalent de print_r
- 
 
 60 
	 * @param mixed $variable la variable à afficher
- 
 
 61 
	 * @param string $mot_cle le mot cle à associer
- 
 
 62 
	 * @param boolean $echo faire un echo ou non
- 
 
 63 
	 * @return string la chaine contenant la variable printée ou null si echo
41 
 
 64 
	 */
42 
	public static function printr($variable, $mot_cle = null, $echo = true) {
 65 
	public static function printr($variable, $mot_cle = null, $echo = true) {
43 
		// Récupération de la sortie
 66 
		// Récupération de la sortie
44 
		$sortie = print_r($variable, true);
 67 
		$sortie = print_r($variable, true);
45 
 
 68 
 
46 
		// Traitement général du débogage
 69 
		// Traitement général du débogage
47 
		return self::traiterDebogage($mot_cle, $sortie, $echo);
 70 
		return self::traiterDebogage($mot_cle, $sortie, $echo);
48 
	}
 71 
	}
- 
 
 72 
 
- 
 
 73 
	/**
- 
 
 74 
	 * Traite une chaine de débogage et les mots clés associés
- 
 
 75 
	 * @param string  $mot_cle le mot à associer à la chaine
- 
 
 76 
	 * @param string  $sortie le chaine de debogage
- 
 
 77 
	 * @param boolean $echo faire un echo du resultat ou non
- 
 
 78 
	 * @return string la chaine de debogage formatée ou bien null si echo
49 
 
 79 
	 */
50 
	private static function traiterDebogage($mot_cle, $sortie, $echo) {
 80 
	private static function traiterDebogage($mot_cle, $sortie, $echo) {
51 
		// Formate le mot-clé
 81 
		// Formate le mot-clé
52 
		$mot_cle = self::formaterMotCle($mot_cle);
 82 
		$mot_cle = self::formaterMotCle($mot_cle);
53 
 
 83 
 
54 
		// Traitement de la sortie
 84 
		// Traitement de la sortie
55 
		$sortie = self::traiterSortieSuivantMode($mot_cle, $sortie);
 85 
		$sortie = self::traiterSortieSuivantMode($mot_cle, $sortie);
56 
 
 86 
 
57 
		// Affichage et/ou retour
 87 
		// Affichage et/ou retour
58 
		if ($echo) {
 88 
		if ($echo) {
59 
			echo $sortie;
 89 
			echo $sortie;
60 
			return null;
 90 
			return null;
61 
		} else {
 91 
		} else {
62 
			return $sortie;
 92 
			return $sortie;
63 
		}
 93 
		}
64 
	}
 94 
	}
- 
 
 95 
 
- 
 
 96 
	/**
- 
 
 97 
	 * formate un mot clé donné
- 
 
 98 
	 * @param string $mot_cle le mot clé à formaté
- 
 
 99 
	 * @return string le mot clé formaté ou bien un chaine vide le mot clé est null ou vide
65 
 
 100 
	 */
66 
	private static function formaterMotCle($mot_cle) {
 101 
	private static function formaterMotCle($mot_cle) {
67 
		return ($mot_cle === null) ? '' : rtrim($mot_cle).' ';
 102 
		return ($mot_cle === null) ? '' : rtrim($mot_cle).' ';
68 
	}
 103 
	}
- 
 
 104 
 
- 
 
 105 
	/**
- 
 
 106 
	 * traite la sortie de la chaine de débogage suivant le mode de php
- 
 
 107 
	 * @param string $mot_cle le mot clé associé à la chaine
- 
 
 108 
	 * @param string  $sortie la chaine de débogage
- 
 
 109 
	 * @return string la sortie formatée pour le mode en cours
69 
 
 110 
	 */
70 
	private static function traiterSortieSuivantMode($mot_cle, $sortie) {
 111 
	private static function traiterSortieSuivantMode($mot_cle, $sortie) {
71 
		$corps = $mot_cle.PHP_EOL.$sortie;
 112 
		$corps = $mot_cle.PHP_EOL.$sortie;
72 
		if (self::getMode() == 'cli') {
 113 
		if (self::getMode() == 'cli') {
73 
			$sortie = PHP_EOL.$corps.PHP_EOL;
 114 
			$sortie = PHP_EOL.$corps.PHP_EOL;
74 
		} else {
 115 
		} else {
75 
			$sortie = '<pre>'.$corps.'</pre>';
 116 
			$sortie = '<pre>'.$corps.'</pre>';
76 
		}
 117 
		}
77 
		return $sortie;
 118 
		return $sortie;
78 
	}
 119 
	}
79 
}
 120 
}
80 
?>
 121 
?>