fr:devel:debugging
Table des matières
Outils de débogage
DokuWiki a des outils de débogage. Certains sont à configurer.
Activer le débogage
Lorsque le paramètre de configuration allowdebug est activé, vous pouvez :
- Ajouter
?do=debug
ou&do=debug
à l'URL pour que DokuWiki produise une énorme liste de chaînes de débogage. - Consulter la sortie de
dbglog()
dansdata/cache/debug.log
. - Recevoir des messages d'erreur supplémentaires, par exemple de certains backends d'authentification
- Ajout de
?httpdebug
ou&httpdebug
à l'URL pour permettre le débogage dans HTTPClient de DokuWiki
Obtenir des informations sur les pages et les utilisateurs
L'ajout de ?do=check
ou &do=check
à l'URL déclenche l' action mode check qui fournit quelques informations sur les permissions des utilisateurs et la configuration de DokuWiki.
Débogage du processus d'exécution des tâches (TaskRunner)
Voir l'info de débogage à la page du processus d'exécution des tâches
Fonctions de débogage
dbg($msg)
Insère un bloc de code dans la page wiki rempli par $msg en texte clair
L'ajout d'un argument supplémentaire àdbg($msg, $hidden=true)
retournera le $msg en commentaire html.
dbglog($msg)
Écrit $msg dans le journal du répertoire de cachedata/cache/debug.log
lorsque le paramètre de configuaration allowdebug est activé. Attention, le journal n'est pas vidé automatiquement.
Utilisez “dbglog($msg, 'Header above log message')” pour inclure un en-tête au-dessus de $msg.
dbg_deprecated($alternative = '')
Fonction permettant de marquer les fonctions obsolètes. Chaque appel est consigné dans le journal de débogage, lorsque le paramètre de configuration allowdebug est activé. Le message du journal mentionne : le nom de la fonction obsolète, la fonction qui l'utilise, son fichier et sa ligne et la$alternative
lorsqu'elle est fournie.
dbg_backtrace()
Imprime une liste inversée de traces de débogage bien imprimée,
debug_guard($data)
Lorsque vous écrivez votre propre fonctionnalité de débogage, utilisez cette fonction pour supprimer toutes les données d'un tableau dont la clé semble pointer vers des données sensibles.
Extension Sentry
L'extension Sentry vous permet d'enregistrer de nombreuses informations dans le service Sentry. Cela est particulièrement utile pour effectuer des tests bêta dans un environnement réel.
Voir aussi
- Paramètre de configuration allowdebug
Crédits
- traduction — digitalin 2020-08-13 19:24
fr/devel/debugging.txt · Dernière modification : 2020-08-13 19:42 de Digitalin