SP:Composant:Debug
De Hegyd Doc.
(→Fonctionnement) |
(→Fonctionnement) |
||
| Ligne 17 : | Ligne 17 : | ||
== Fonctionnement == | == 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'': | ''Exemple'': | ||
| Ligne 31 : | Ligne 35 : | ||
</pre> | </pre> | ||
Le trio n'est pas obligatoire, mais sert a mieux cibler l'opération effectuée (classe, méthode). | 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. | 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 == | == 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. | 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. | ||
Version du 7 juillet 2010 à 12:43
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.
