Subversion Repositories Applications.gtt

<?php
// +------------------------------------------------------------------------------------------------------+
// | PHP version 5.0.4                                                                                    |
// +------------------------------------------------------------------------------------------------------+
// | Copyright (C) 2005 Tela Botanica (accueil@tela-botanica.org)                                         |
// +------------------------------------------------------------------------------------------------------+
// | This file is part of eFlore-Debogage.                                                                |
// |                                                                                                      |
// | Foobar is free software; you can redistribute it and/or modify                                       |
// | it under the terms of the GNU General Public License as published by                                 |
// | the Free Software Foundation; either version 2 of the License, or                                    |
// | (at your option) any later version.                                                                  |
// |                                                                                                      |
// | Foobar is distributed in the hope that it will be useful,                                            |
// | but WITHOUT ANY WARRANTY; without even the implied warranty of                                       |
// | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the                                        |
// | GNU General Public License for more details.                                                         |
// |                                                                                                      |
// | You should have received a copy of the GNU General Public License                                    |
// | along with Foobar; if not, write to the Free Software                                                |
// | Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA                            |
// +------------------------------------------------------------------------------------------------------+
// CVS : $Id: Chronometre.class.php,v 1.1 2007-01-12 13:16:09 jp_milcent Exp $
/**
* Classe permettant de mesurer le temps d'execution d'un script.
*
* Contient des méthodes permettant d'évaluer la vitesse d'exécution d'un script.
*
*@package eFlore
*@subpackage Debogage
//Auteur original :
*@author        Jean-Pascal MILCENT <jpm@tela-botanica.org>
//Autres auteurs :
*@author        aucun
*@copyright     Tela-Botanica 2000-2005
*@version       $Revision: 1.1 $ $Date: 2007-01-12 13:16:09 $
// +------------------------------------------------------------------------------------------------------+
*/

// +------------------------------------------------------------------------------------------------------+
// |                                            ENTETE du PROGRAMME                                       |
// +------------------------------------------------------------------------------------------------------+


// +------------------------------------------------------------------------------------------------------+
// |                                            CORPS du PROGRAMME                                        |
// +------------------------------------------------------------------------------------------------------+
/**Classe 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.
* 
* @author       Jean-Pascal MILCENT <jpm@tela-botanica.org>
*/
class Chronometre
{
        /*** Attributs : ***/
        private $temps = array();
        private $temps_sql = 0;
        
        /*** Constructeur : ***/
        public function __construct() {
                $this->setTemps(array('depart' => microtime()));
        }
        
        /*** Accesseurs : ***/
        
        // Temps
        public function getTemps($cle = NULL) {
                if (!is_null($cle)) {
                        return $this->temps[$cle];
                } else {
                        return $this->temps;
                }
        }
        public function setTemps($moment = array()) {
                array_push($this->temps, $moment);      
        }

        // Temps Sql
        // Notes : utiliser microtime(true) pour renvoyer un float
        public function getTempsSql() {
                return $this->temps_sql;
        }
        public function setTempsSql($tps_deb, $tps_fin = null) {
                if (is_null($tps_fin)) {
                        if (is_float($tps_deb)) {
                                $this->temps_sql += $tps_deb;
                        }
                } else {
                        if (is_float($tps_deb) && is_float($tps_fin)) {
                                $this->temps_sql += $tps_fin - $tps_deb;
                        }
                }
        }
        
        /*** Méthodes : ***/
        
        /**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.
        * 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.
        * Elle utilise une variable gobale : $_CHRONO_
        *
        * @author   Loic d'Anterroches
        * @author        Jean-Pascal MILCENT <jpm@tela-botanica.org>
        * @param    int     l'indentation de base pour le code html du tableau.
        * @param    int     le pas d'indentation pour le code html du tableau.
        * @return   string  la chaine XHTML de mesure des temps.
        */
        function afficherChrono($indentation_origine = 8, $indentation = 4)     {
                // Création du chrono de fin
                $GLOBALS['_EFLORE_']['chrono']->setTemps(array('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);
                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 ($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;
        }

}

/* +--Fin du code ----------------------------------------------------------------------------------------+
*
* $Log$
*
* +-- Fin du code ----------------------------------------------------------------------------------------+
*/
?>