WebSVN – Applications.framework – Diff – /branches/v0.2-buhl/doc/PhpDoc/files/Chronometre.php.txt

 <?php
 // declare(encoding='UTF-8');
-/** Classe Chronometre() - Permet de stocker et d'afficher
+/** Classe Chronometre() - Permet de stocker et d'afficher les temps d'éxécution de script.
- * les temps d'éxécution de script.
+ *
- * Cette classe permet de réaliser un ensemble
+ * Cette classe permet de réaliser un ensemble de mesure de temps prises à différents endroits d'un script.
- * de mesure de temps prises à
- * différents endroits d'un script.
- * Ces mesures peuvent ensuite être affichées au
+ * Ces mesures peuvent ensuite être affichées au sein d'un tableau XHTML.
- * sein d'un tableau XHTML.
+ *
- *
- * PHP Version 5
- *
- * @category  PHP
+ * @category	PHP 5.2
- * @package   Framework
+ * @package		Framework
- * @author	Jean-Pascal MILCENT <jpm@tela-botanica.org>
+ * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
- * @copyright 2009 Tela-Botanica
+ * @copyright	Copyright (c) 2009, Tela Botanica (accueil@tela-botanica.org)
- * @license   http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
+ * @license		GNU-GPL-v3 <http://www.gnu.org/licenses/gpl.html>
- * @version   Release: <package_version>
+ * @license		CECILL-v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt>
- * @link	  /doc/framework/
  */
 class Chronometre {
 	/*** Attributs : ***/
+	private static $instance = null;
-	private $_temps = array();
+	private static $temps = array();
 	/** Constructeur : **/
-	public function __construct() {
+	private function __construct() {
-		$this->setTemps(array('depart' => microtime()));
+		self::setTemps('depart', microtime());
+	}
 	/** Accesseurs :
+	 *
 	 * @param string $cle la cle associée à un chronomètre particulier
+	 *
 	 * @return int le temps écoulé
 	 */
-	public function getTemps($cle = null) {
+	private static function getTemps($cle = null) {
 		$temps = '';
 		if (!is_null($cle)) {
-			$temps = $this->_temps[$cle];
+			$temps = self::$temps[$cle];
 		} else {
-			$temps = $this->_temps;
+			$temps = self::$temps;
+		}
 		return $temps;
+	}
 	/** Setteur pour la variable temps
+	 *
 	 * @param array() $moment ajoute des points de chronométrage au tableau _temps
+	 *
 	 * @return null
 	 */
-	public function setTemps($moment = array ()) {
+	private static function setTemps($cle, $moment) {
-		array_push($this->_temps, $moment);
+		array_push(self::$temps, array($cle => $moment));
+	}
 	/*** Méthodes : ***/
+	/**
+	 *	Effectue un chronometrage.
+	 *
+	 * @param string le nom du point de chronométrage
+	 * @return null
+	 */
+	public static function chrono($cle) {
+		$moment = microtime();
+		self::verifierCreationInstance();
+		self::setTemps($cle, $moment);
+	}
-	/** Méthode afficherChrono() -
+	/**
 	* Permet d'afficher les temps d'éxécution de différentes parties d'un script.
-	*
-	* Cette fonction permet d'afficher un ensemble de
+	*
-	* mesure de temps prises à différents endroits d'un script.
+	* Cette fonction permet d'afficher un ensemble de  mesure de temps prises à différents endroits d'un script.
-	* Ces mesures sont affichées au sein d'un tableau XHTML
-	* dont on peut controler l'indentation des balises.
+	* Ces mesures sont affichées au sein d'un tableau XHTML dont on peut controler l'indentation des balises.
-	* Pour un site en production, il suffit d'ajouter un style
-	* #chrono {display:none;} dans la css. De cette façon,
+	* Pour un site en production, il suffit d'ajouter un style #chrono {display:none;} dans la css.
-	* le tableau ne s'affichera pas. Le webmaster lui pourra
+	* De cette façon, le tableau ne s'affichera pas. Le webmaster lui pourra rajouter sa propre feuille de style
-	* rajouter sa propre feuille de style affichant le tableau.
+	* affichant le tableau.
 	* Le développeur initial de cette fonction est Loic d'Anterroches.
-	* Elle a été modifiée par Jean-Pascal Milcent.
-	* Elle utilise une variable gobale : $_CHRONO_
+	* Elle a été modifiée par Jean-Pascal Milcent.
+	*
 	* @author   Loic d'Anterroches
-	* @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
+	* @author	Jean-Pascal MILCENT <jpm@tela-botanica.org>
+	*
 	* @param	int	 $indentation_origine l'indentation de base.
 	* @param	int	 $indentation le pas d'indentation.
 	* @return   string  la chaine XHTML de mesure des temps.
 	*/
-	public function afficherChrono($indentation_origine = 8, $indentation = 4) {
+	public static function afficherChrono($indentation_origine = 8, $indentation = 4) {
+		self::verifierCreationInstance();
 		// Création du chrono de fin
-		$GLOBALS['_SCRIPT_']['chrono']->setTemps(array (
-			'fin' => microtime()
+		self::setTemps('fin', microtime());
-		));
 		// Début création de l'affichage
 		$sortie = str_repeat(' ', $indentation_origine) .
 		'<table id="chrono" lang="fr" summary="Résultat du
 			chronométrage du programme affichant la page actuelle.">' . "\n";
 		$sortie .= str_repeat(' ', ($indentation_origine + ($indentation * 1))) .
 		'<caption>Chronométrage</caption>' . "\n";
 		$sortie .= str_repeat(' ', ($indentation_origine + ($indentation * 1))) .
 		'<thead>' . "\n";
 		$sortie .= str_repeat(' ', ($indentation_origine + ($indentation * 2))) .
 		'<tr><th>Action</th><th>Temps écoulé (en s.)</th>
 		<th>Cumul du temps écoulé (en s.)</th></tr>' . "\n";
 		$sortie .= str_repeat(' ', ($indentation_origine + ($indentation * 1))) .
 		'</thead>' . "\n";
 		$tbody = str_repeat(' ', ($indentation_origine + ($indentation * 1))) .
 		'<tbody>' . "\n";
 		$total_tps_ecoule = 0;
 		// Récupération de la premiére mesure
-		$tab_depart = & $this->getTemps(0);
+		$tab_depart = self::getTemps(0);
 		list ($usec, $sec) = explode(' ', $tab_depart['depart']);
 		// Ce temps correspond à tps_fin
 		$tps_debut = ((float) $usec + (float) $sec);
-		foreach ($this->getTemps() as $tab_temps) {
+		foreach (self::getTemps() as $tab_temps) {
 			foreach ($tab_temps as $cle => $valeur) {
 				list ($usec, $sec) = explode(' ', $valeur);
 				$tps_fin = ((float) $usec + (float) $sec);
 				$tps_ecoule = abs($tps_fin - $tps_debut);
 				$total_tps_ecoule += $tps_ecoule;
 				$tbody .= str_repeat(' ',
 								($indentation_origine + ($indentation * 2))) .
 				'<tr>' .
 				'<th>' . $cle . '</th>' .
 				'<td>' . number_format($tps_ecoule, 3, ',', ' ') . '</td>' .
 				'<td>' . number_format($total_tps_ecoule, 3, ',', ' ') . '</td>' .
 				'</tr>' . "\n";
 				$tps_debut = $tps_fin;
+			}
+		}
 		$tbody .= str_repeat(' ', ($indentation_origine + ($indentation * 1))) .
 		'</tbody>' . "\n";
 		$sortie .= str_repeat(' ', ($indentation_origine + ($indentation * 1))) .
 		'<tfoot>' . "\n";
 		$sortie .= str_repeat(' ', ($indentation_origine + ($indentation * 2))) .
 		'<tr>' .
 		'<th>' . 'Total du temps écoulé (en s.)' . '</th>' .
 		'<td colspan="2">' .
 			number_format($total_tps_ecoule, 3, ',', ' ') . '</td>' .
 		'</tr>' . "\n";
 		$sortie .= str_repeat(' ', ($indentation_origine + ($indentation * 1))) .
 		'</tfoot>' . "\n";
 		$sortie .= $tbody;
 		$sortie .= str_repeat(' ', $indentation_origine) .
 		'</table>' . "\n";
 		return $sortie;
+	}
+	/**
+	 * Vérifie si l'instance de classe à été crée, si non la crée
+	 */
+	private static function verifierCreationInstance() {
+		if (empty(self::$instance)) {
+			self::$instance = new Chronometre();
+		}
+	}
+}
 ?>

Subversion Repositories Applications.framework

(root)/branches/v0.2-buhl/doc/PhpDoc/files/Chronometre.php.txt – Rev 467 → 476