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