Subversion Repositories Applications.framework

<?php
// declare(encoding='UTF-8');
/** Fichier de la classe Chronometre
* 
* 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   SVN: <svn_id> 
* @link      /doc/framework/ 
*/

/** 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;
    }
}
?>