Subversion Repositories Applications.framework

<?php

/** 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)

    {

        if (!is_null($cle)) {

            return $this->_temps[$cle];

        } else {

            return $this->_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.

    */

    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;

    }

}

?>