SP:Composant:Debug

De Hegyd Doc.

Version du 7 juillet 2010 à 12:35 par Sebd (discuter | contributions)
(diff) ← Version précédente | Voir la version courante (diff) | Version suivante → (diff)


Sommaire

Debug

Le composant debug permet de debugger plus aisement le code en proposant de tracer les différentes opérations effectuées sur un script.

Implémenté sur toute les classes métiers,

Implémentation

La classe Debug gère l'ensemble des fonctionnalités du composant.

Activation

Le debug est activé dans le cas ou la variable de configuration DEBUG est a true, et que la variable de context clean ne vaut pas 1 (peut être passé en paramètre d'URL).

Fonctionnement

La class Debug propose 3 fonctions qui permettent de tracer les opérations effectuées, montrées dans l'exemple suivant:

Exemple:

        public function deployFromSite($siteClientId)
        {
                global $db;
                Debug::setClass("SiteClient"); //definit la classe
                Debug::setFunction("deployFromSite"); //defini la fonction
                Debug::trace("deploy content from site (siteClientId)".$siteClientId); // trace qui défini le message
                ...
        }

Le trio n'est pas obligatoire, mais sert a mieux cibler l'opération effectuée (classe, méthode).


La fonction Debug::trace prends n'importe quel type d'argument en paramètre: un tableau, un objet, une chaine de caractères.

Affichage

Si le mode est activé, il est possible d'afficher directement la pile de message dans le format souhaité: HTML pour une page web, text pour des scripts de type cron. Pour ce faire il suffit d'utiliser la fonction Debug::setOutputHTML(true/false) pour activer ou non le format de sortie HTML.