Subversion Repositories Applications.framework

Rev

Rev 467 | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 467 Rev 476
Line 1... Line 1...
1 
<?php
 1 
<?php
2 
// declare(encoding='UTF-8');
 2 
// declare(encoding='UTF-8');
3 
/** Classe Chronometre() - Permet de stocker et d'afficher
 3 
/** Classe Chronometre() - Permet de stocker et d'afficher les temps d'éxécution de script.
4 
 * les temps d'éxécution de script.
 - 
 
5 
 *
 4 
 *
6 
 * Cette classe permet de réaliser un ensemble
 5 
 * Cette classe permet de réaliser un ensemble de mesure de temps prises à différents endroits d'un script.
7 
 * de mesure de temps prises à
 - 
 
8 
 * différents endroits d'un script.
 - 
 
9 
 * Ces mesures peuvent ensuite être affichées au
 6 
 * Ces mesures peuvent ensuite être affichées au sein d'un tableau XHTML.
10 
 * sein d'un tableau XHTML.
 - 
 
11 
 *
 7 
 *
12 
 *
 - 
 
13 
 * PHP Version 5
 - 
 
14 
 *
 - 
 
15 
 * @category  PHP
 8 
 * @category	PHP 5.2
16 
 * @package   Framework
 9 
 * @package		Framework
17 
 * @author	Jean-Pascal MILCENT <jpm@tela-botanica.org>
 10 
 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
18 
 * @copyright 2009 Tela-Botanica
 11 
 * @copyright	Copyright (c) 2009, Tela Botanica (accueil@tela-botanica.org)
19 
 * @license   http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
 12 
 * @license		GNU-GPL-v3 <http://www.gnu.org/licenses/gpl.html>
20 
 * @version   Release: <package_version>
 13 
 * @license		CECILL-v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt>
21 
 * @link	  /doc/framework/
 - 
 
22 
 */
 14 
 */
23 
class Chronometre {
 15 
class Chronometre {
24 
	/*** Attributs : ***/
 16 
	/*** Attributs : ***/
- 
 
 17 
	private static $instance = null;
25 
	private $_temps = array();
 18 
	private static $temps = array();
Line 26... Line 19...
26 
 
 19 
 
27 
	/** Constructeur : **/
 20 
	/** Constructeur : **/
28 
	public function __construct() {
 21 
	private function __construct() {
29 
		$this->setTemps(array('depart' => microtime()));
 22 
		self::setTemps('depart', microtime());
Line 30... Line 23...
30 
	}
 23 
	}
31 
 
 24 
 
32 
	/** Accesseurs :
 25 
	/** Accesseurs :
33 
	 *
 26 
	 *
34 
	 * @param string $cle la cle associée à un chronomètre particulier
 27 
	 * @param string $cle la cle associée à un chronomètre particulier
35 
	 *
 28 
	 *
36 
	 * @return int le temps écoulé
 29 
	 * @return int le temps écoulé
37 
	 */
 30 
	 */
38 
	public function getTemps($cle = null) {
 31 
	private static function getTemps($cle = null) {
39 
		$temps = '';
 32 
		$temps = '';
40 
		if (!is_null($cle)) {
 33 
		if (!is_null($cle)) {
41 
			$temps = $this->_temps[$cle];
 34 
			$temps = self::$temps[$cle];
42 
		} else {
 35 
		} else {
43 
			$temps = $this->_temps;
 36 
			$temps = self::$temps;
44 
		}
 37 
		}
Line 45... Line 38...
45 
		return $temps;
 38 
		return $temps;
46 
	}
 39 
	}
47 
 
 40 
 
48 
	/** Setteur pour la variable temps
 41 
	/** Setteur pour la variable temps
49 
	 *
 42 
	 *
50 
	 * @param array() $moment ajoute des points de chronométrage au tableau _temps
 43 
	 * @param array() $moment ajoute des points de chronométrage au tableau _temps
51 
	 *
 44 
	 *
52 
	 * @return null
 45 
	 * @return null
53 
	 */
 46 
	 */
Line 54... Line 47...
54 
	public function setTemps($moment = array ()) {
 47 
	private static function setTemps($cle, $moment) {
Line -... Line 48...
- 
 
 48 
		array_push(self::$temps, array($cle => $moment));
- 
 
 49 
	}
- 
 
 50 
 
- 
 
 51 
	/*** Méthodes : ***/
- 
 
 52 
 
- 
 
 53 
	/**
55 
		array_push($this->_temps, $moment);
 54 
	 *	Effectue un chronometrage.
- 
 
 55 
	 *
- 
 
 56 
	 * @param string le nom du point de chronométrage
- 
 
 57 
	 * @return null
- 
 
 58 
	 */
- 
 
 59 
	public static function chrono($cle) {
- 
 
 60 
		$moment = microtime();
56 
	}
 61 
		self::verifierCreationInstance();
57 
 
 62 
		self::setTemps($cle, $moment);
58 
	/*** Méthodes : ***/
 - 
 
59 
 
 63 
	}
60 
	/** Méthode afficherChrono() -
 64 
 
61 
	* Permet d'afficher les temps d'éxécution de différentes parties d'un script.
 - 
 
62 
	*
 65 
	/**
63 
	* Cette fonction permet d'afficher un ensemble de
 - 
 
64 
	* mesure de temps prises à différents endroits d'un script.
 66 
	* Permet d'afficher les temps d'éxécution de différentes parties d'un script.
65 
	* Ces mesures sont affichées au sein d'un tableau XHTML
 67 
	*
66 
	* dont on peut controler l'indentation des balises.
 68 
	* Cette fonction permet d'afficher un ensemble de  mesure de temps prises à différents endroits d'un script.
67 
	* Pour un site en production, il suffit d'ajouter un style
 69 
	* Ces mesures sont affichées au sein d'un tableau XHTML dont on peut controler l'indentation des balises.
68 
	* #chrono {display:none;} dans la css. De cette façon,
 - 
 
69 
	* le tableau ne s'affichera pas. Le webmaster lui pourra
 70 
	* Pour un site en production, il suffit d'ajouter un style #chrono {display:none;} dans la css.
70 
	* rajouter sa propre feuille de style affichant le tableau.
 71 
	* De cette façon, le tableau ne s'affichera pas. Le webmaster lui pourra rajouter sa propre feuille de style
71 
	* Le développeur initial de cette fonction est Loic d'Anterroches.
 72 
	* affichant le tableau.
72 
	* Elle a été modifiée par Jean-Pascal Milcent.
 73 
	* Le développeur initial de cette fonction est Loic d'Anterroches.
73 
	* Elle utilise une variable gobale : $_CHRONO_
 74 
	* Elle a été modifiée par Jean-Pascal Milcent.
74 
	*
 75 
	*
75 
	* @author   Loic d'Anterroches
 76 
	* @author   Loic d'Anterroches
76 
	* @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
 77 
	* @author	Jean-Pascal MILCENT <jpm@tela-botanica.org>
77 
	*
 78 
	*
- 
 
 79 
	* @param	int	 $indentation_origine l'indentation de base.
78 
	* @param	int	 $indentation_origine l'indentation de base.
 80 
	* @param	int	 $indentation le pas d'indentation.
79 
	* @param	int	 $indentation le pas d'indentation.
 - 
 
80 
	* @return   string  la chaine XHTML de mesure des temps.
 81 
	* @return   string  la chaine XHTML de mesure des temps.
81 
	*/
 - 
 
Line 82... Line 82...
82 
	public function afficherChrono($indentation_origine = 8, $indentation = 4) {
 82 
	*/
83 
		// Création du chrono de fin
 83 
	public static function afficherChrono($indentation_origine = 8, $indentation = 4) {
84 
		$GLOBALS['_SCRIPT_']['chrono']->setTemps(array (
 84 
		self::verifierCreationInstance();
85 
			'fin' => microtime()
 85 
		// Création du chrono de fin
Line 103... Line 103...
103 
		'<tbody>' . "\n";
 103 
		'<tbody>' . "\n";
Line 104... Line 104...
104 
 
 104 
 
Line 105... Line 105...
105 
		$total_tps_ecoule = 0;
 105 
		$total_tps_ecoule = 0;
106 
 
 106 
 
107 
		// Récupération de la premiére mesure
 107 
		// Récupération de la premiére mesure
Line 108... Line 108...
108 
		$tab_depart = & $this->getTemps(0);
 108 
		$tab_depart = self::getTemps(0);
109 
		list ($usec, $sec) = explode(' ', $tab_depart['depart']);
 109 
		list ($usec, $sec) = explode(' ', $tab_depart['depart']);
Line 110... Line 110...
110 
 
 110 
 
111 
		// Ce temps correspond à tps_fin
 111 
		// Ce temps correspond à tps_fin
112 
		$tps_debut = ((float) $usec + (float) $sec);
 112 
		$tps_debut = ((float) $usec + (float) $sec);
113 
 
 113 
 
Line 114... Line 114...
114 
		foreach ($this->getTemps() as $tab_temps) {
 114 
		foreach (self::getTemps() as $tab_temps) {
Line 146... Line 146...
146 
		$sortie .= str_repeat(' ', $indentation_origine) .
 146 
		$sortie .= str_repeat(' ', $indentation_origine) .
147 
		'</table>' . "\n";
 147 
		'</table>' . "\n";
Line 148... Line 148...
148 
 
 148 
 
149 
		return $sortie;
 149 
		return $sortie;
- 
 
 150 
	}
- 
 
 151 
 
- 
 
 152 
	/**
- 
 
 153 
	 * Vérifie si l'instance de classe à été crée, si non la crée
- 
 
 154 
	 */
- 
 
 155 
	private static function verifierCreationInstance() {
- 
 
 156 
		if (empty(self::$instance)) {
- 
 
 157 
			self::$instance = new Chronometre();
- 
 
 158 
		}
150 
	}
 159 
	}
151 
}
 160 
}