DokuWiki

It's better when it's simple

Outils pour utilisateurs

Outils du site


fr:devel:debugging

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() dans data/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 cache data/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

Crédits

fr/devel/debugging.txt · Dernière modification : 2020-08-13 19:42 de Digitalin

Sauf mention contraire, le contenu de ce wiki est placé sous les termes de la licence suivante : CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki