Subversion Repositories Applications.framework

<?php
// declare(encoding='UTF-8');
/** 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.
 *
 *
 * PHP Version 5
 *
 * @category  PHP
 * @package   Framework
 * @author      Jean-Pascal MILCENT <jpm@tela-botanica.org>
 * @copyright 2009 Tela-Botanica
 * @license   http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
 * @version   Release: <package_version>
 * @link          /doc/framework/
 */
class Chronometre {
        /*** Attributs : ***/
        private $_temps = array();

        /** Constructeur : **/
        public function __construct() {
                $this->setTemps(array('depart' => microtime()));
        }

        /** Accesseurs :
         *
         * @param string $cle la cle associée à un chronomètre particulier
         *
         * @return int le temps écoulé
         */
        public function getTemps($cle = null) {
                $temps = '';
                if (!is_null($cle)) {
                        $temps = $this->_temps[$cle];
                } else {
                        $temps = $this->_temps;
                }
                return $temps;
        }

        /** Setteur pour la variable temps
         *
         * @param array() $moment ajoute des points de chronométrage au tableau _temps
         *
         * @return null
         */
        public function setTemps($moment = array ()) {
                array_push($this->_temps, $moment);
        }

        /*** 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      $indentation_origine l'indentation de base.
        * @param        int      $indentation le pas d'indentation.
        * @return   string  la chaine XHTML de mesure des temps.
        */
        public function afficherChrono($indentation_origine = 8, $indentation = 4) {
                // Création du chrono de fin
                $GLOBALS['_SCRIPT_']['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;
        }
}
?>