26.2 Comment déboguer un site WordPress?

Vous lancez votre site WordPress et vous n'obtenez pas les résultats escomptés? Ou, pire encore, le programme plante?

Les techniques de débogage sont tout aussi pertinentes pour un site WordPress que pour tout autre programme.

Je vous propose ici une liste d'étapes plus spécifiquement adaptées à WordPress :

1. Commencez par vous assurer que la constante WP_DEBUG est à true et que la constante WP_DEBUG_LOG contient le chemin vers un fichier journal (nommé généralement debug.log).
   1. Ouvrez le fichier debug.log dans l'application Geany, supprimez son contenu puis enregistrez-le. Ceci vous assurera de ne voir que les nouveaux messages. Note : le fichier sera inexistant si les constantes étaient à false ou encore si le programme n'a jamais rencontré de code qui lui demande d'écrire dans debug.log.
   2. Affichez à nouveau votre programme afin qu'il inscrive dans le fichier debug.log les messages d'erreur, s'il y a lieu.
   3. Si le fichier debug.log affiche un message d'erreur, vérifiez la ligne de code qui a causé l'erreur.
2. Pendant la phase de développement seulement, faites afficher les message d'erreur à l'écran en définissant la constante WP_DEBUG_DISPLAY à true. 
3. Si le problème n'est toujours pas réglé, ajoutez un point d'arrêt sur une ligne de code près de l'endroit où vous soupçonnez le problème puis lancez le site avec l'icône de débogage.
4. Si le programme ne s'arrête pas sur le point d'arrrêt, c'est peut-être parce que la ligne n'est jamais atteinte. Est-ce qu'elle est dans un if dont la condition est fausse? Est-ce qu'elle est dans une fonction qui n'est jamais appelée?
5. Lorsque le débogueur s'arrête sur une ligne, profitez-en pour vérifier la valeur des variables et/ou pour exécuter le code une ligne à la fois pour voir quelles lignes sont exécutées.
6. Si vous ne comprenez toujours pas ce qui se passe, essayez d'afficher le code source de la page Web. Autrement dit, essayez de voir ce que le navigateur voit. Peut-être que votre code PHP n'a pas bien généré le code HTML (le validateur W3C pourrait vous aider). Peut-être qu'il y a un problème avec une classe CSS?
7. Une technique que j'aime bien utiliser consiste à faire des énormités. Par exemple, ajoutez un X devant un libellé puis rafraîchissez la page. Si le X n'apparaît pas, c'est probablement parce que vous ne travaillez pas dans le bon fichier.
8. Si votre code utilise du JavaScript, vérifiez dans la console du navigateur s'il y a des erreurs JavaScript et corrigez-les au besoin.
9. Ajoutez un point d'arrêt dans le code JavaScript à l'aide du débogueur JavaScript du navigateur.
10. Si le code JavaScript ne semble pas se charger, vérifiez dans le code source de la page si la balise <script> est présente et si elle utilise le bon chemin pour atteindre le fichier. Cliquez sur le nom du fichier pour voir s'il contient le bon code. Peut-être que vous avez oublié de faire une actualisation forcée.