Outils de débogage WordPress natifs qui ne nécessitent pas d’IDE

Last updated Déc 3, 2022

Teneur

Outils de débogage WordPress natifs

Configurer WordPress

Plugins pour le débogage

Examen des journaux d’erreurs

Si vous venez de devenir membre du site et que vous recherchez du contenu spécifiquement pour The Independent WordPress Developer, je vous recommande de lire le post précédent – à tout le moins – pour vous préparer au contenu de ce post.

Si, toutefois, vous cherchez à rattraper l’article précédent, voici une courte liste de tout ce qui a été écrit jusqu’à présent :

Alors que nous nous préparons à aborder des sujets plus avancés tels que le débogage et les IDE, il convient d’abord de noter les outils dont nous disposons que nous pouvons installer dans WordPress qui nous aideront à résoudre les problèmes de débogage pendant le développement.

De plus, ces problèmes ne sont pas strictement liés à PHP. Ceux-ci incluent également les problèmes de JavaScript. Et pour aller plus loin, il existe des moyens de configurer WordPress de manière native afin qu’il génère des erreurs directement dans notre navigateur.

Donc, avant d’examiner les journaux d’erreurs, les IDE, Xdebug, etc., nous allons examiner ce que nous pouvons faire dans WordPress lui-même.

Outils de débogage WordPress natifs

Les outils de débogage WordPress natifs sont une combinaison de deux choses :

les options que nous pouvons définir dans le fichier de configuration WordPress qui nous permettent de voir les informations écrites à l’écran,
plusieurs plugins qui nous aideront à travailler avec des fichiers PHP et JavaScript depuis la zone d’administration de WordPress

Pour le deuxième point ci-dessus, je tiens à préciser qu’il existe de nombreux plugins disponibles pour quelque chose comme ça ; cependant, je veux garder l’installation aussi simple que possible afin que nous ne soyons pas submergés par trop d’informations.

Au lieu de cela, je veux que nous disposions des informations dont nous avons besoin pour tester et évaluer notre travail, mais que nous n’ayons que ce dont nous avons besoin. Au moins pour l’instant. Nous parlerons peut-être de sujets avancés dans de futurs articles.

Cela dit, commençons.

Configurer WordPress

Avant de vous soucier de la configuration, WordPress lui-même propose différentes options que nous pouvons configurer dans le wp-config.phpfichier. Celles-ci sont bien documentées dans le Codex, mais je sais par expérience des e-mails d’autres personnes que les informations peuvent être un peu difficiles à parcourir.

Tout d’abord, il est important de noter ce qui suit (tel que cité dans le WordPress Codex):

WP_DEBUG est une constante PHP (une variable globale permanente) qui peut être utilisée pour déclencher le mode "débogage" dans WordPress. Il est supposé être faux par défaut et est généralement défini sur vrai dans le fichier wp-config.php sur les copies de développement de WordPress.

Cela suppose que vous comprenez les constantes PHP. Sinon, consultez le manuel ici (il est assez simple). Le court de celui-ci est le suivant:

Une constante est un identifiant (nom) pour une valeur simple.

Je vais donc faire ce que je peux pour fournir les options de configuration aussi distillées que possible.

Tout d’abord, dans le wp-config.phpfichier, vous voudrez changer la ligne qui se lit comme suit :

<?php
define( 'WP_DEBUG', false );

A ceci :

<?php
define( 'WP_DEBUG', true );

Ce n’est pas tout, cependant. Il y a quelques autres choses à ajouter qui amélioreront l’expérience de débogage :

<?php
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', true );
@ini_set( 'display_errors', 1 );
define( 'SCRIPT_DEBUG', true );
define( 'SAVEQUERIES', true );

Si vous suivez le Mais que signifie chaque ligne ? Voici une explication aussi succincte que je peux donner maintenant:

WP_DEBUG. Cela affichera toutes les erreurs et tous les avertissements générés par PHP lors de l’exécution de WordPress. L’exécution de l’application par elle-même ne devrait poser aucun problème ; cependant, l’exécuter avec divers plugins peut être une histoire différente selon la qualité du plugin.
WP_DEBUG_LOG. C’est l’une de mes constantes préférées, et elle écrit toute la sortie dans le journal de manière détaillée. Je vais couvrir cela dans un prochain article mais, pour l’instant, sachez que c’est quelque chose qui, selon moi, devrait toujours être défini dans votre environnement de développement.
WP_DEBUG_DISPLAY. C’est celui que vous pouvez définir sur vrai ou faux (bien que je préfère vrai). Il complète le paramètre précédent en vous permettant de voir les messages dans le navigateur qui sont également écrits sur le blog. Je ne sais pas si c’est quelque chose que vous trouverez bénéfique ou non. Si vous n’êtes pas prêt à parcourir les traces de la pile et des informations plus détaillées, vous pouvez envisager de définir celle-ci sur true.
afficher_erreurs. Le Codex mentionne que vous pouvez le définir sur false, mais je pense qu’il devrait être défini sur true pour activer les erreurs et les avertissements.
SCRIPT_DEBUG. Le noyau de WordPress utilise des versions réduites des fichiers CSS et JavaScript. La désactivation de ce paramètre vous permettra d’afficher tout le contenu des fichiers dans leur forme d’origine. Ceci est particulièrement utile si vous allez contribuer à Core ou travailler sur JavaScript inclus dans Core.
SAVEQUERIES. C’est un réglage un peu plus avancé, à mon avis. En bref, il va prendre toutes les requêtes qui s’exécutent sur la base de données et les enregistrer dans un tableau PHP que vous pourrez ensuite analyser. Ce

Maintenant que nous avons couvert la configuration de WordPress, qu’en est-il des plugins ?

Plugins pour le débogage

Quand je dis que le référentiel regorge de plugins pour cela, je le pense. En fait, si vous débutez dans le développement de WordPress, je vous déconseille de chercher des éléments à installer.

Cela peut vite devenir écrasant, vous risquez de ne pas comprendre ce que font certains d’entre eux, et potentiellement de vous conduire sur une voie dans laquelle vous finirez par faire échouer votre installation.

Plutôt que de faire cela, je vous recommande de jeter un œil aux plugins suivants (en lisant d’abord leur description, bien sûr), puis de partir de là :

Barre de débogage. Ce plugin ajoute à lui seul un menu à la barre d’administration qui vous permettra de voir la requête, le cache et d’autres informations. Cela nécessite que WP_DEBUG et SAVEQUERIES, comme indiqué ci-dessus, soient activés.
Debug Bar List Script & Dépendances de style. Il s’agit d’un module complémentaire au plugin ci-dessus qui vous permettra de déboguer d’autres styles JavaScript et CSS qui s’exécutent dans le contexte de WordPress.
Console de barre de débogage. Ce plugin est celui que vous devriez utiliser avec hésitation. À tout le moins, il vous permet d’exécuter PHP et MySQL à partir de WordPress lui-même. Je ne recommande pas ce plugin à moins que vous ne soyez très à l’aise avec l’une des deux langues. Pourtant, si vous l’êtes, c’est quelque chose qui peut être puissant pour prototyper une fonction ou une requête avant de l’intégrer à votre plugin.

Examen des journaux d’erreurs

Dans le prochain article, nous commencerons à examiner ce qui est nécessaire pour examiner le journal des erreurs généré par WordPress et comment comprendre les informations que nous voyons.

De plus, nous allons examiner ce qui est nécessaire pour utiliser les plugins décrits dans cet article. Après cela, nous passerons à des outils encore plus avancés.

Mais une étape à la fois, n’est-ce pas ?

Pour l’instant cependant, configurez votre installation comme indiqué ci-dessus, installez les plugins liés, puis faites ce que vous pouvez pour explorer leur fonctionnement, ce que vous pouvez voir à l’écran et comment cela peut avoir un impact positif sur votre développement.

Oui, il peut y avoir un peu de courbe d’apprentissage. Mais c’est pourquoi nous prenons ce lent. Il y a beaucoup à apprendre et nous avons tout le temps nécessaire pour couvrir tout le terrain nécessaire.

Source d’enregistrement: tommcfarlin.com