Subversion Repositories Applications.framework

Rev

Details | Last modification | View Log | RSS feed

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