SP:Composant:Debug
De Hegyd Doc.
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
Chaque fonction appelable depuis l'object debug se fera selon la syntaxe statique Debug::{method}({args});, et est accessible partout. Aucune initialisation n'es tnécessaire au préalable, hormi la configuration qui permet d'activer ou non le debug, avant le premier appel à Debug::xxx.
Tracer les opération effectuées
3 fonctions 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.
Afficher la pile d'élements
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.
