Débogage avec Studio

WordPress Studio inclut plusieurs outils intégrés pour vous aider à identifier et corriger les problèmes sur vos sites WordPress locaux — sans avoir besoin d’installer de logiciel supplémentaire ni de quitter l’application.

Journal de débogage

Parfois, vous avez simplement besoin de voir ce que WordPress enregistre. Studio facilite cela grâce à une option dédiée au journal de débogage qui configure automatiquement WP_DEBUG et WP_DEBUG_LOG pour votre site.

Activer le journal de débogage

1. Sélectionnez le site que vous souhaitez déboguer.
2. Accédez à l’onglet Réglages.
3. Cliquez sur « Modifier le site ».
4. Ouvrez l’onglet Débogage.
5. Activez Activer le journal de débogage.
6. Cliquez sur Enregistrer.

Lorsque le journal de débogage est activé, votre site consigne les erreurs, avis et avertissements PHP dans wp-content/debug.log. Un lien Ouvrir le fichier journal apparaîtra dans l’onglet Réglages, afin que vous puissiez accéder directement au fichier sans avoir à chercher son chemin.

Vous pouvez également écrire vos propres messages dans le journal à l’aide de la fonction PHP error_log() :

error_log( 'My value: ' . print_r( $my_variable, true ) );

Afficher les erreurs dans le navigateur

L’onglet Débogage inclut également une option Afficher les erreurs dans le navigateur, qui définit WP_DEBUG_DISPLAY. Lorsqu’elle est activée, les erreurs et avertissements PHP s’affichent directement dans la sortie de la page au lieu d’être consignés silencieusement dans le fichier journal — utile lorsque vous souhaitez un retour immédiat pendant le développement actif.

Gardez à l’esprit :

• Afficher les erreurs dans le navigateur fonctionne mieux en complément du journal de débogage, pas en remplacement.
• Désactivez cette option sur tout site que vous partagez avec des clients — elle peut exposer des informations sur les chemins internes ou d’autres détails d’implémentation dans la sortie de la page.

Utiliser des agents IA pour interpréter les journaux de débogage

Une fois votre journal de débogage activé, vous pouvez diriger un agent IA directement vers celui-ci. Indiquez à votre agent — que vous utilisiez Claude Code, Cursor ou un autre outil — que les journaux d’erreurs sont disponibles dans wp-content/debug.log. À partir de là, il peut lire la sortie, identifier ce qui ne va pas et suggérer des corrections sans interrompre votre flux de travail.

Accès à la base de données avec phpMyAdmin

Inspecter ou modifier votre base de données locale nécessitait auparavant un outil distinct et une configuration distincte. Studio inclut un accès à phpMyAdmin directement depuis l’onglet Vue d’ensemble — vous pouvez ainsi interroger les tables, vérifier les données et déboguer les problèmes de schéma sans quitter l’application ni rien configurer.

Pour ouvrir phpMyAdmin pour un site, sélectionnez le site et cliquez sur le bouton phpMyAdmin dans l’onglet Vue d’ensemble.

Débogage pas à pas avec Xdebug

Pour une investigation plus approfondie, Studio inclut la prise en charge de Xdebug. Au lieu de disperser des sorties de débogage dans votre code, vous pouvez définir des points d’arrêt, parcourir l’exécution ligne par ligne et inspecter les variables en temps réel — le tout depuis votre éditeur.

Xdebug est disponible pour tous les sites Studio et ne nécessite aucune installation au niveau du système. Studio écoute les connexions de débogage sur le port 9003.

Pour obtenir les instructions de configuration complètes, notamment pour connecter VS Code et PhpStorm, consultez Xdebug dans Studio.