Rev 302 | Blame | Compare with Previous | Last modification | View Log | RSS feed
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><!-- template designed by Marco Von Ballmoos --><title>File Source for Chronometre.php</title><meta http-equiv='Content-Type' content='text/html; charset=UTF-8'/><link rel="stylesheet" href="../media/stylesheet.css" /></head><body><h1>Source for file Chronometre.php</h1><p>Documentation is available at <a href="../Framework/_Chronometre.php.html">Chronometre.php</a></p><div class="src-code"><div class="src-code"><ol><li><div class="src-line"><a name="a1"></a><span class="src-php"><?php</span></div></li><li><div class="src-line"><a name="a2"></a><span class="src-comm">// declare(encoding='UTF-8');</span></div></li><li><div class="src-line"><a name="a3"></a><span class="src-doc">/** Chronometre permet de stocker et d'afficher les temps d'éxécution de script.</span></div></li><li><div class="src-line"><a name="a4"></a><span class="src-doc"> *</span></div></li><li><div class="src-line"><a name="a5"></a><span class="src-doc"> * Cette classe permet de réaliser un ensemble de mesure de temps prises à différents endroits d'un script.</span></div></li><li><div class="src-line"><a name="a6"></a><span class="src-doc"> * Ces mesures peuvent ensuite être affichées au sein d'un tableau XHTML.</span></div></li><li><div class="src-line"><a name="a7"></a><span class="src-doc"> *</span></div></li><li><div class="src-line"><a name="a8"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@category</span><span class="src-doc"> PHP 5.2</span></div></li><li><div class="src-line"><a name="a9"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@package</span><span class="src-doc"> Framework</span></div></li><li><div class="src-line"><a name="a10"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@author</span><span class="src-doc"> Jean-Pascal MILCENT <jpm@tela-botanica.org></span></div></li><li><div class="src-line"><a name="a11"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@copyright</span><span class="src-doc"> Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org)</span></div></li><li><div class="src-line"><a name="a12"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@license</span><span class="src-doc"> http://www.gnu.org/licenses/gpl.html Licence GNU-GPL-v3</span></div></li><li><div class="src-line"><a name="a13"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@license</span><span class="src-doc"> http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL-v2</span></div></li><li><div class="src-line"><a name="a14"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@version</span><span class="src-doc"> $Id: Chronometre.php 241 2010-12-06 15:19:07Z jpm $</span></div></li><li><div class="src-line"><a name="a15"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@link</span><span class="src-doc"> /doc/framework/</span></div></li><li><div class="src-line"><a name="a16"></a><span class="src-doc"> */</span></div></li><li><div class="src-line"><a name="a17"></a><span class="src-key">class </span><a href="../Framework/Chronometre.html">Chronometre</a> <span class="src-sym">{</span></div></li><li><div class="src-line"><a name="a18"></a> <span class="src-comm">/*** Attributs : ***/</span></div></li><li><div class="src-line"><a name="a19"></a> <span class="src-key">private </span><span class="src-key">static </span><span class="src-var">$pointArretNumero </span>= <span class="src-num">1</span><span class="src-sym">;</span></div></li><li><div class="src-line"><a name="a20"></a> <span class="src-key">private </span><span class="src-key">static </span><span class="src-var">$temps </span>= <span class="src-key">array</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li><li><div class="src-line"><a name="a21"></a> </div></li><li><div class="src-line"><a name="a22"></a> <span class="src-doc">/** Accesseurs :</span></div></li><li><div class="src-line"><a name="a23"></a><span class="src-doc"> *</span></div></li><li><div class="src-line"><a name="a24"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">string </span><span class="src-doc-var">$cle </span><span class="src-doc">la cle associée à un chronomètre particulier</span></div></li><li><div class="src-line"><a name="a25"></a><span class="src-doc"> *</span></div></li><li><div class="src-line"><a name="a26"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">int </span><span class="src-doc">le temps écoulé</span></div></li><li><div class="src-line"><a name="a27"></a><span class="src-doc"> */</span></div></li><li><div class="src-line"><a name="a28"></a> <span class="src-key">private </span><span class="src-key">static </span><span class="src-key">function </span><span class="src-id">getTemps</span><span class="src-sym">(</span><span class="src-var">$cle </span>= <span class="src-id">null</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li><li><div class="src-line"><a name="a29"></a> <span class="src-var">$temps </span>= <span class="src-sym">(</span><a href="http://www.php.net/is_null">is_null</a><span class="src-sym">(</span><span class="src-var">$cle</span><span class="src-sym">)) </span>? <span class="src-id">self</span><span class="src-sym">::</span><span class="src-var">$temps </span>: <span class="src-id">self</span><span class="src-sym">::</span><span class="src-var">$temps</span><span class="src-sym">[</span><span class="src-var">$cle</span><span class="src-sym">]</span><span class="src-sym">;</span></div></li><li><div class="src-line"><a name="a30"></a> <span class="src-key">return </span><span class="src-var">$temps</span><span class="src-sym">;</span></div></li><li><div class="src-line"><a name="a31"></a> <span class="src-sym">}</span></div></li><li><div class="src-line"><a name="a32"></a> </div></li><li><div class="src-line"><a name="a33"></a> <span class="src-doc">/** Setteur pour la variable temps</span></div></li><li><div class="src-line"><a name="a34"></a><span class="src-doc"> *</span></div></li><li><div class="src-line"><a name="a35"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">array() </span><span class="src-doc-var">$moment </span><span class="src-doc">ajoute des points de chronométrage au tableau _temps</span></div></li><li><div class="src-line"><a name="a36"></a><span class="src-doc"> *</span></div></li><li><div class="src-line"><a name="a37"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">null </span></div></li><li><div class="src-line"><a name="a38"></a><span class="src-doc"> */</span></div></li><li><div class="src-line"><a name="a39"></a> <span class="src-key">private </span><span class="src-key">static </span><span class="src-key">function </span><span class="src-id">setTemps</span><span class="src-sym">(</span><span class="src-var">$cle</span><span class="src-sym">, </span><span class="src-var">$moment</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li><li><div class="src-line"><a name="a40"></a> <span class="src-id">array_push</span><span class="src-sym">(</span><span class="src-id">self</span><span class="src-sym">::</span><span class="src-var">$temps</span><span class="src-sym">, </span><span class="src-key">array</span><span class="src-sym">(</span><span class="src-var">$cle </span>=> <span class="src-var">$moment</span><span class="src-sym">))</span><span class="src-sym">;</span></div></li><li><div class="src-line"><a name="a41"></a> <span class="src-sym">}</span></div></li><li><div class="src-line"><a name="a42"></a> </div></li><li><div class="src-line"><a name="a43"></a> <span class="src-comm">/*** Méthodes : ***/</span></div></li><li><div class="src-line"><a name="a44"></a> </div></li><li><div class="src-line"><a name="a45"></a> <span class="src-doc">/** </span></div></li><li><div class="src-line"><a name="a46"></a><span class="src-doc"> * Effectue un chronometrage.</span></div></li><li><div class="src-line"><a name="a47"></a><span class="src-doc"> * Vous pouvez indiquer le nom du point de chronométrage.</span></div></li><li><div class="src-line"><a name="a48"></a><span class="src-doc"> * Si vous n'indiquez rien, un nombre sera généré en débutant à 1.</span></div></li><li><div class="src-line"><a name="a49"></a><span class="src-doc"> *</span></div></li><li><div class="src-line"><a name="a50"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">string </span><span class="src-doc">le nom du point de chronométrage</span></div></li><li><div class="src-line"><a name="a51"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">null </span></div></li><li><div class="src-line"><a name="a52"></a><span class="src-doc"> */</span></div></li><li><div class="src-line"><a name="a53"></a> <span class="src-key">public </span><span class="src-key">static </span><span class="src-key">function </span><a href="../Framework/Chronometre.html#methodchrono">chrono</a><span class="src-sym">(</span><span class="src-var">$cle </span>= <span class="src-id">null</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li><li><div class="src-line"><a name="a54"></a> <span class="src-var">$cle </span>= <span class="src-sym">(</span><span class="src-var">$cle </span>== <span class="src-id">null</span><span class="src-sym">) </span>? <span class="src-id">self</span><span class="src-sym">::</span><span class="src-var">$pointArretNumero</span>++ : <span class="src-var">$cle</span><span class="src-sym">;</span></div></li><li><div class="src-line"><a name="a55"></a> <span class="src-var">$moment </span>= <span class="src-id">microtime</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li><li><div class="src-line"><a name="a56"></a> <span class="src-id">self</span><span class="src-sym">::</span><span class="src-id">setTemps</span><span class="src-sym">(</span><span class="src-var">$cle</span><span class="src-sym">, </span><span class="src-var">$moment</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li><li><div class="src-line"><a name="a57"></a> <span class="src-sym">}</span></div></li><li><div class="src-line"><a name="a58"></a> </div></li><li><div class="src-line"><a name="a59"></a> <span class="src-doc">/** </span></div></li><li><div class="src-line"><a name="a60"></a><span class="src-doc"> * Permet d'afficher les temps d'éxécution de différentes parties d'un script.</span></div></li><li><div class="src-line"><a name="a61"></a><span class="src-doc"> *</span></div></li><li><div class="src-line"><a name="a62"></a><span class="src-doc"> * Cette fonction permet d'afficher un ensemble de mesure de temps prises à différents endroits d'un script.</span></div></li><li><div class="src-line"><a name="a63"></a><span class="src-doc"> * Ces mesures sont affichées au sein d'un tableau XHTML dont on peut controler l'indentation des balises.</span></div></li><li><div class="src-line"><a name="a64"></a><span class="src-doc"> * Pour un site en production, il suffit d'ajouter un style #chrono {display:none;} dans la css.</span></div></li><li><div class="src-line"><a name="a65"></a><span class="src-doc"> * De cette façon, le tableau ne s'affichera pas. Le webmaster lui pourra rajouter sa propre feuille de style</span></div></li><li><div class="src-line"><a name="a66"></a><span class="src-doc"> * affichant le tableau.</span></div></li><li><div class="src-line"><a name="a67"></a><span class="src-doc"> * Le développeur initial de cette fonction est Loic d'Anterroches.</span></div></li><li><div class="src-line"><a name="a68"></a><span class="src-doc"> * Elle a été modifiée par Jean-Pascal Milcent.</span></div></li><li><div class="src-line"><a name="a69"></a><span class="src-doc"> *</span></div></li><li><div class="src-line"><a name="a70"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@author</span><span class="src-doc"> Loic d'Anterroches</span></div></li><li><div class="src-line"><a name="a71"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@author</span><span class="src-doc"> Jean-Pascal MILCENT <jpm@tela-botanica.org></span></div></li><li><div class="src-line"><a name="a72"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">string </span><span class="src-doc">l'eventuel nom du point de chronométrage de fin.</span></div></li><li><div class="src-line"><a name="a73"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc"> </span><span class="src-doc-type">string </span><span class="src-doc"> la chaine XHTML de mesure des temps.</span></div></li><li><div class="src-line"><a name="a74"></a><span class="src-doc"> */</span></div></li><li><div class="src-line"><a name="a75"></a> <span class="src-key">public </span><span class="src-key">static </span><span class="src-key">function </span><a href="../Framework/Chronometre.html#methodafficherChrono">afficherChrono</a><span class="src-sym">(</span><span class="src-var">$cle </span>= <span class="src-id">null</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li><li><div class="src-line"><a name="a76"></a> <span class="src-comm">// Création du chrono de fin</span></div></li><li><div class="src-line"><a name="a77"></a> <span class="src-id">self</span><span class="src-sym">::</span><span class="src-id">chrono</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li><li><div class="src-line"><a name="a78"></a> </div></li><li><div class="src-line"><a name="a79"></a> <span class="src-var">$total_tps_ecoule </span>= <span class="src-num">0</span><span class="src-sym">;</span></div></li><li><div class="src-line"><a name="a80"></a> <span class="src-comm">// Récupération de la premiére mesure</span></div></li><li><div class="src-line"><a name="a81"></a> <span class="src-var">$tab_depart </span>= <span class="src-id">self</span><span class="src-sym">::</span><span class="src-id">getTemps</span><span class="src-sym">(</span><span class="src-num">0</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li><li><div class="src-line"><a name="a82"></a> list <span class="src-sym">(</span><span class="src-var">$usec</span><span class="src-sym">, </span><span class="src-var">$sec</span><span class="src-sym">) </span>= <a href="http://www.php.net/explode">explode</a><span class="src-sym">(</span><span class="src-str">' '</span><span class="src-sym">, </span><span class="src-var">$tab_depart</span><span class="src-sym">[</span><span class="src-str">'depart'</span><span class="src-sym">]</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li><li><div class="src-line"><a name="a83"></a> </div></li><li><div class="src-line"><a name="a84"></a> <span class="src-comm">// Ce temps correspond à tps_fin</span></div></li><li><div class="src-line"><a name="a85"></a> <span class="src-var">$tps_debut </span>= <span class="src-sym">(</span>(float) <span class="src-var">$usec </span>+ (float) <span class="src-var">$sec</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li><li><div class="src-line"><a name="a86"></a> </div></li><li><div class="src-line"><a name="a87"></a> <span class="src-var">$tbody </span>= <span class="src-str">''</span><span class="src-sym">;</span></div></li><li><div class="src-line"><a name="a88"></a> <span class="src-key">foreach </span><span class="src-sym">(</span><span class="src-id">self</span><span class="src-sym">::</span><span class="src-id">getTemps</span><span class="src-sym">(</span><span class="src-sym">) </span><span class="src-key">as </span><span class="src-var">$tab_temps</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li><li><div class="src-line"><a name="a89"></a> <span class="src-key">foreach </span><span class="src-sym">(</span><span class="src-var">$tab_temps </span><span class="src-key">as </span><span class="src-var">$cle </span>=> <span class="src-var">$valeur</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li><li><div class="src-line"><a name="a90"></a> list <span class="src-sym">(</span><span class="src-var">$usec</span><span class="src-sym">, </span><span class="src-var">$sec</span><span class="src-sym">) </span>= <a href="http://www.php.net/explode">explode</a><span class="src-sym">(</span><span class="src-str">' '</span><span class="src-sym">, </span><span class="src-var">$valeur</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li><li><div class="src-line"><a name="a91"></a> <span class="src-var">$tps_fin </span>= <span class="src-sym">(</span>(float) <span class="src-var">$usec </span>+ (float) <span class="src-var">$sec</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li><li><div class="src-line"><a name="a92"></a> </div></li><li><div class="src-line"><a name="a93"></a> <span class="src-var">$tps_ecoule </span>= <a href="http://www.php.net/abs">abs</a><span class="src-sym">(</span><span class="src-var">$tps_fin </span>- <span class="src-var">$tps_debut</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li><li><div class="src-line"><a name="a94"></a> <span class="src-var">$total_tps_ecoule </span>+= <span class="src-var">$tps_ecoule</span><span class="src-sym">;</span></div></li><li><div class="src-line"><a name="a95"></a> <span class="src-var">$tps_debut </span>= <span class="src-var">$tps_fin</span><span class="src-sym">;</span></div></li><li><div class="src-line"><a name="a96"></a> </div></li><li><div class="src-line"><a name="a97"></a> <span class="src-comm">// Gestion affichage</span></div></li><li><div class="src-line"><a name="a98"></a> <span class="src-var">$total_tps_ecoule_fmt </span>= <a href="http://www.php.net/number_format">number_format</a><span class="src-sym">(</span><span class="src-var">$total_tps_ecoule</span><span class="src-sym">, </span><span class="src-num">3</span><span class="src-sym">, </span><span class="src-str">','</span><span class="src-sym">, </span><span class="src-str">' '</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li><li><div class="src-line"><a name="a99"></a> <span class="src-var">$tps_ecoule_fmt </span>= <a href="http://www.php.net/number_format">number_format</a><span class="src-sym">(</span><span class="src-var">$tps_ecoule</span><span class="src-sym">, </span><span class="src-num">3</span><span class="src-sym">, </span><span class="src-str">','</span><span class="src-sym">, </span><span class="src-str">' '</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li><li><div class="src-line"><a name="a100"></a> <span class="src-var">$tbody </span>.= <span class="src-str">'<tr><th>'</span>.<span class="src-var">$cle</span>.<span class="src-str">'</th><td>'</span>.<span class="src-var">$tps_ecoule_fmt</span>.<span class="src-str">'</td><td>'</span>.<span class="src-var">$total_tps_ecoule_fmt</span>.<span class="src-str">'</td></tr>'</span>.<span class="src-str">"\n"</span><span class="src-sym">;</span></div></li><li><div class="src-line"><a name="a101"></a> <span class="src-sym">}</span></div></li><li><div class="src-line"><a name="a102"></a> <span class="src-sym">}</span></div></li><li><div class="src-line"><a name="a103"></a> <span class="src-var">$total_tps_ecoule_final_fmt </span>= <a href="http://www.php.net/number_format">number_format</a><span class="src-sym">(</span><span class="src-var">$total_tps_ecoule</span><span class="src-sym">, </span><span class="src-num">3</span><span class="src-sym">, </span><span class="src-str">','</span><span class="src-sym">, </span><span class="src-str">' '</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li><li><div class="src-line"><a name="a104"></a> <span class="src-comm">// Début création de l'affichage</span></div></li><li><div class="src-line"><a name="a105"></a> <span class="src-var">$sortie </span>= <span class="src-str">'<table id="chrono" lang="fr" summary="Résultat duchronométrage du programme affichant la page actuelle.">'</span>.<span class="src-str">"\n"</span>.</div></li><li><div class="src-line"><a name="a106"></a> <span class="src-str">'<caption>Chronométrage</caption>'</span>.<span class="src-str">"\n"</span>.</div></li><li><div class="src-line"><a name="a107"></a> <span class="src-str">'<thead>'</span>.<span class="src-str">"\n"</span>.</div></li><li><div class="src-line"><a name="a108"></a> <span class="src-str">' <tr><th>Action</th><th>Temps écoulé (en s.)</th><th>Cumul du temps écoulé (en s.)</th></tr>'</span>.<span class="src-str">"\n"</span>.</div></li><li><div class="src-line"><a name="a109"></a> <span class="src-str">'</thead>'</span>.<span class="src-str">"\n"</span>.</div></li><li><div class="src-line"><a name="a110"></a> <span class="src-str">'<tbody>'</span>.<span class="src-str">"\n"</span>.</div></li><li><div class="src-line"><a name="a111"></a> <span class="src-var">$tbody</span>.</div></li><li><div class="src-line"><a name="a112"></a> <span class="src-str">'</tbody>'</span>.<span class="src-str">"\n"</span>.</div></li><li><div class="src-line"><a name="a113"></a> <span class="src-str">'<tfoot>'</span>.<span class="src-str">"\n"</span>.</div></li><li><div class="src-line"><a name="a114"></a> <span class="src-str">' <tr><th>Total du temps écoulé (en s.)</th><td colspan="2">'</span>.<span class="src-var">$total_tps_ecoule_final_fmt</span>.<span class="src-str">'</td></tr>'</span>.<span class="src-str">"\n"</span>.</div></li><li><div class="src-line"><a name="a115"></a> <span class="src-str">'</tfoot>'</span>.<span class="src-str">"\n"</span>.</div></li><li><div class="src-line"><a name="a116"></a> <span class="src-str">'</table>'</span>.<span class="src-str">"\n"</span><span class="src-sym">;</span></div></li><li><div class="src-line"><a name="a117"></a> </div></li><li><div class="src-line"><a name="a118"></a> <span class="src-key">return </span><span class="src-var">$sortie</span><span class="src-sym">;</span></div></li><li><div class="src-line"><a name="a119"></a> <span class="src-sym">}</span></div></li><li><div class="src-line"><a name="a120"></a><span class="src-sym">}</span></div></li><li><div class="src-line"><a name="a121"></a><span class="src-php">?></span></div></li></ol></div></div><p class="notes" id="credit">Documentation generated on Tue, 18 Jan 2011 15:30:45 +0100 by <a href="http://www.phpdoc.org" target="_blank">phpDocumentor 1.4.3</a></p></body></html>