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