Subversion Repositories Applications.framework

<?php

// declare(encoding='UTF-8');

/** Chronometre permet de stocker et d'afficher les temps d'éxécution de script.

 *

 * Cette classe permet de réaliser un ensemble de mesure de temps prises à différents endroits d'un script.

 * Ces mesures peuvent ensuite être affichées au sein d'un tableau XHTML.

 *

 * @category	PHP 5.2

 * @package	Framework

 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>

 * @copyright	Copyright (c) 2009, Tela Botanica (accueil@tela-botanica.org)

 * @license	http://www.gnu.org/licenses/gpl.html Licence GNU-GPL-v3

 * @license	http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL-v2

 * @version	$Id: Chronometre.php 239 2010-11-25 18:04:00Z jpm $

 * @link		/doc/framework/

 */

class Chronometre {

	/*** Attributs : ***/

	private static $pointArretNumero = 1;

	private static $temps = array();

	/** Accesseurs :

	 *

	 * @param string $cle la cle associée à un chronomètre particulier

	 *

	 * @return int le temps écoulé

	 */

	private static function getTemps($cle = null) {

		$temps = (is_null($cle)) ? self::$temps : self::$temps[$cle];

		return $temps;

	}

	/** Setteur pour la variable temps

	 *

	 * @param array() $moment ajoute des points de chronométrage au tableau _temps

	 *

	 * @return null

	 */

	private static function setTemps($cle, $moment) {

		array_push(self::$temps, array($cle => $moment));

	}

	/*** Méthodes : ***/

	/**

	 *	Effectue un chronometrage.

	 * Vous pouvez indiquer le nom du point de chronométrage.

	 * Si vous n'indiquez rien, un nombre sera généré en débutant à 1.

	 *

	 * @param string le nom du point de chronométrage

	 * @return null

	 */

	public static function chrono($cle = null) {

		$cle = ($cle == null) ? self::$pointArretNumero++ : $cle;

		$moment = microtime();

		self::setTemps($cle, $moment);

	}

	/**

	* 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.

	* 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, le tableau ne s'affichera pas. Le webmaster lui pourra rajouter sa propre feuille de style

	* affichant le tableau.

	* Le développeur initial de cette fonction est Loic d'Anterroches.

	* Elle a été modifiée par Jean-Pascal Milcent.

	*

	* @author Loic d'Anterroches

	* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>

	* @param string l'eventuel nom du point de chronométrage de fin.

	* @return   string  la chaine XHTML de mesure des temps.

	*/

	public static function afficherChrono($cle = null) {

		// Création du chrono de fin

		self::chrono();

		$total_tps_ecoule = 0;

		// Récupération de la premiére mesure

		$tab_depart = self::getTemps(0);

		list ($usec, $sec) = explode(' ', $tab_depart['depart']);

		// Ce temps correspond à tps_fin

		$tps_debut = ((float) $usec + (float) $sec);

		$tbody = '';

		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;

				$tps_debut = $tps_fin;

				// Gestion affichage

				$total_tps_ecoule_fmt = number_format($total_tps_ecoule, 3, ',', ' ');

				$tps_ecoule_fmt = number_format($tps_ecoule, 3, ',', ' ');

				$tbody .= '<tr><th>'.$cle.'</th><td>'.$tps_ecoule_fmt.'</td><td>'.$total_tps_ecoule_fmt.'</td></tr>'."\n";

			}

		}

		$total_tps_ecoule_final_fmt = number_format($total_tps_ecoule, 3, ',', ' ');

		// Début création de l'affichage

		$sortie = '<table id="chrono" lang="fr" summary="Résultat duchronométrage du programme affichant la page actuelle.">'."\n".

			'<caption>Chronométrage</caption>'."\n".

			'<thead>'."\n".

			'	<tr><th>Action</th><th>Temps écoulé (en s.)</th><th>Cumul du temps écoulé (en s.)</th></tr>'."\n".

			'</thead>'."\n".

			'<tbody>'."\n".

				$tbody.

			'</tbody>'."\n".

			'<tfoot>'."\n".

			'	<tr><th>Total du temps écoulé (en s.)</th><td colspan="2">'.$total_tps_ecoule_final_fmt.'</td></tr>'."\n".

			'</tfoot>'."\n".

			'</table>'."\n";

		return $sortie;

	}

}

?>