Subversion Repositories Applications.framework

Rev

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

Rev Author Line No. Line
5 aurelien 1 
<?php
105 aurelien 2 
// declare(encoding='UTF-8');
186 jpm 3 
/** Classe Chronometre() - Permet de stocker et d'afficher les temps d'éxécution de script.
129 aurelien 4 
 *
186 jpm 5 
 * Cette classe permet de réaliser un ensemble de mesure de temps prises à différents endroits d'un script.
6 
 * Ces mesures peuvent ensuite être affichées au sein d'un tableau XHTML.
129 aurelien 7 
 *
186 jpm 8 
 * @category	PHP 5.2
9 
 * @package		Framework
10 
 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
11 
 * @copyright	Copyright (c) 2009, Tela Botanica (accueil@tela-botanica.org)
12 
 * @license		http://www.gnu.org/licenses/gpl.html Licence GNU-GPL-v3
13 
 * @license		http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL-v2
14 
 * @version		SVN : $Id: Chronometre.php 186 2010-04-28 15:50:16Z jpm $
15 
 * @link		/doc/framework/
129 aurelien 16 
 */
84 jpm 17 
class Chronometre {
120 aurelien 18 
	/*** Attributs : ***/
186 jpm 19 
	private static $instance = null;
20 
	private static $temps = array();
5 aurelien 21 
 
120 aurelien 22 
	/** Constructeur : **/
186 jpm 23 
	private function __construct() {
24 
		self::setTemps('depart', microtime());
120 aurelien 25 
	}
5 aurelien 26 
 
120 aurelien 27 
	/** Accesseurs :
28 
	 *
122 aurelien 29 
	 * @param string $cle la cle associée à un chronomètre particulier
120 aurelien 30 
	 *
122 aurelien 31 
	 * @return int le temps écoulé
120 aurelien 32 
	 */
186 jpm 33 
	private static function getTemps($cle = null) {
120 aurelien 34 
		$temps = '';
35 
		if (!is_null($cle)) {
186 jpm 36 
			$temps = self::$temps[$cle];
120 aurelien 37 
		} else {
186 jpm 38 
			$temps = self::$temps;
120 aurelien 39 
		}
40 
		return $temps;
41 
	}
5 aurelien 42 
 
120 aurelien 43 
	/** Setteur pour la variable temps
44 
	 *
122 aurelien 45 
	 * @param array() $moment ajoute des points de chronométrage au tableau _temps
120 aurelien 46 
	 *
47 
	 * @return null
48 
	 */
186 jpm 49 
	private static function setTemps($cle, $moment) {
50 
		array_push(self::$temps, array($cle => $moment));
120 aurelien 51 
	}
5 aurelien 52 
 
120 aurelien 53 
	/*** Méthodes : ***/
186 jpm 54 
 
55 
	/**
56 
	 *	Effectue un chronometrage.
57 
	 *
58 
	 * @param string le nom du point de chronométrage
59 
	 * @return null
60 
	 */
61 
	public static function chrono($cle) {
62 
		$moment = microtime();
63 
		self::verifierCreationInstance();
64 
		self::setTemps($cle, $moment);
65 
	}
66 
 
67 
	/**
120 aurelien 68 
	* Permet d'afficher les temps d'éxécution de différentes parties d'un script.
69 
	*
186 jpm 70 
	* Cette fonction permet d'afficher un ensemble de  mesure de temps prises à différents endroits d'un script.
71 
	* Ces mesures sont affichées au sein d'un tableau XHTML dont on peut controler l'indentation des balises.
72 
	* Pour un site en production, il suffit d'ajouter un style #chrono {display:none;} dans la css.
73 
	* De cette façon, le tableau ne s'affichera pas. Le webmaster lui pourra rajouter sa propre feuille de style
74 
	* affichant le tableau.
120 aurelien 75 
	* Le développeur initial de cette fonction est Loic d'Anterroches.
76 
	* Elle a été modifiée par Jean-Pascal Milcent.
77 
	*
78 
	* @author   Loic d'Anterroches
186 jpm 79 
	* @author	Jean-Pascal MILCENT <jpm@tela-botanica.org>
120 aurelien 80 
	*
81 
	* @param	int	 $indentation_origine l'indentation de base.
82 
	* @param	int	 $indentation le pas d'indentation.
83 
	* @return   string  la chaine XHTML de mesure des temps.
84 
	*/
186 jpm 85 
	public static function afficherChrono($indentation_origine = 8, $indentation = 4) {
86 
		self::verifierCreationInstance();
120 aurelien 87 
		// Création du chrono de fin
186 jpm 88 
		self::setTemps('fin', microtime());
5 aurelien 89 
 
120 aurelien 90 
		// Début création de l'affichage
91 
		$sortie = str_repeat(' ', $indentation_origine) .
92 
		'<table id="chrono" lang="fr" summary="Résultat du
93 
			chronométrage du programme affichant la page actuelle.">' . "\n";
94 
		$sortie .= str_repeat(' ', ($indentation_origine + ($indentation * 1))) .
95 
		'<caption>Chronométrage</caption>' . "\n";
96 
		$sortie .= str_repeat(' ', ($indentation_origine + ($indentation * 1))) .
97 
		'<thead>' . "\n";
98 
		$sortie .= str_repeat(' ', ($indentation_origine + ($indentation * 2))) .
99 
		'<tr><th>Action</th><th>Temps écoulé (en s.)</th>
100 
		<th>Cumul du temps écoulé (en s.)</th></tr>' . "\n";
101 
		$sortie .= str_repeat(' ', ($indentation_origine + ($indentation * 1))) .
102 
		'</thead>' . "\n";
5 aurelien 103 
 
120 aurelien 104 
		$tbody = str_repeat(' ', ($indentation_origine + ($indentation * 1))) .
105 
		'<tbody>' . "\n";
5 aurelien 106 
 
120 aurelien 107 
		$total_tps_ecoule = 0;
5 aurelien 108 
 
120 aurelien 109 
		// Récupération de la premiére mesure
186 jpm 110 
		$tab_depart = self::getTemps(0);
120 aurelien 111 
		list ($usec, $sec) = explode(' ', $tab_depart['depart']);
5 aurelien 112 
 
120 aurelien 113 
		// Ce temps correspond à tps_fin
114 
		$tps_debut = ((float) $usec + (float) $sec);
5 aurelien 115 
 
186 jpm 116 
		foreach (self::getTemps() as $tab_temps) {
120 aurelien 117 
			foreach ($tab_temps as $cle => $valeur) {
118 
				list ($usec, $sec) = explode(' ', $valeur);
119 
				$tps_fin = ((float) $usec + (float) $sec);
5 aurelien 120 
 
120 aurelien 121 
				$tps_ecoule = abs($tps_fin - $tps_debut);
122 
				$total_tps_ecoule += $tps_ecoule;
5 aurelien 123 
 
120 aurelien 124 
				$tbody .= str_repeat(' ',
125 
								($indentation_origine + ($indentation * 2))) .
126 
				'<tr>' .
127 
				'<th>' . $cle . '</th>' .
128 
				'<td>' . number_format($tps_ecoule, 3, ',', ' ') . '</td>' .
129 
				'<td>' . number_format($total_tps_ecoule, 3, ',', ' ') . '</td>' .
130 
				'</tr>' . "\n";
131 
				$tps_debut = $tps_fin;
132 
			}
133 
		}
134 
		$tbody .= str_repeat(' ', ($indentation_origine + ($indentation * 1))) .
135 
		'</tbody>' . "\n";
5 aurelien 136 
 
120 aurelien 137 
		$sortie .= str_repeat(' ', ($indentation_origine + ($indentation * 1))) .
138 
		'<tfoot>' . "\n";
139 
		$sortie .= str_repeat(' ', ($indentation_origine + ($indentation * 2))) .
140 
		'<tr>' .
141 
		'<th>' . 'Total du temps écoulé (en s.)' . '</th>' .
142 
		'<td colspan="2">' .
143 
			number_format($total_tps_ecoule, 3, ',', ' ') . '</td>' .
144 
		'</tr>' . "\n";
145 
		$sortie .= str_repeat(' ', ($indentation_origine + ($indentation * 1))) .
146 
		'</tfoot>' . "\n";
147 
		$sortie .= $tbody;
148 
		$sortie .= str_repeat(' ', $indentation_origine) .
149 
		'</table>' . "\n";
5 aurelien 150 
 
120 aurelien 151 
		return $sortie;
152 
	}
186 jpm 153 
 
154 
	/**
155 
	 * Vérifie si l'instance de classe à été crée, si non la crée
156 
	 */
157 
	private static function verifierCreationInstance() {
158 
		if (empty(self::$instance)) {
159 
			self::$instance = new Chronometre();
160 
		}
161 
	}
5 aurelien 162 
}
163 
?>