WordPress Studio : de nouveaux outils de débogage pour le développement local

Déboguer un site WordPress peut vite ressembler à chercher une aiguille dans une botte de foin, surtout si vous vous appuyez sur des appels à var_dump() et que vous parcourez manuellement les journaux d’erreurs.

WordPress Studio introduit deux nouvelles fonctionnalités qui rendent ce processus plus simple, plus rapide et plus agréable : la prise en charge de Xdebug et un accès facilité au journal de débogage.

Débogage pas à pas avec Xdebug

Xdebug est l’extension de débogage PHP la plus utilisée. Plutôt que de multiplier les sorties de débogage dans votre code, vous pouvez définir des points d’arrêt, exécuter le code ligne par ligne et inspecter les variables en temps réel — directement depuis votre éditeur.

Cette fonctionnalité est désormais disponible pour tous les utilisateurs de Studio. Elle repose sur la version WebAssembly de PHP intégrée à WordPress Playground, ce qui signifie qu’aucune installation ni configuration supplémentaire n’est nécessaire.

Activer Xdebug

Sélectionnez le site que vous souhaitez déboguer dans Studio.

1. Ouvrez l’onglet Réglages.
2. Cliquez sur Modifier le site.
3. Accédez à l’onglet Débogage.
4. Cochez Activer Xdebug.
5. Cliquez sur Enregistrer.

Studio redémarre automatiquement le site avec Xdebug activé.

À savoir

• Un seul site à la fois : Xdebug ne peut être activé que sur un seul site. Pour l’utiliser ailleurs, désactivez-le d’abord sur le site actuel. Une icône en forme de bug indique le site concerné dans la barre latérale.
• Performances réduites : l’activation de Xdebug peut ralentir sensiblement votre site. Activez-le uniquement lorsque vous en avez besoin.

Connecter votre éditeur

Une fois Xdebug activé, vous pouvez connecter votre éditeur et commencer à analyser vos problèmes — qu’ils proviennent d’une extension, d’un thème ou du cœur de WordPress. Studio écoute les connexions sur le port 9003.

Consultez la documentation Xdebug de Studio pour connaître les étapes de configuration complètes.

Accéder plus facilement au journal de débogage

Dans certains cas, un débogueur complet n’est pas nécessaire. Vous souhaitez simplement consulter les erreurs enregistrées par WordPress.

Studio simplifie cela grâce à une option dédiée qui active automatiquement WP_DEBUG et WP_DEBUG_LOG pour vos sites.

Activer le journal de débogage

1. Sélectionnez votre site et cliquez sur Modifier le site.
2. Ouvrez l’onglet Débogage.
3. Activez l’option Activer le journal de débogage.
4. Cliquez sur Enregistrer.

Une fois activé, votre site local enregistre les erreurs PHP, les avertissements et les notices dans le fichier wp-content/debug.log.

Un lien Ouvrir le fichier journal apparaît alors dans les réglages, vous permettant d’y accéder directement — sans avoir à rechercher son emplacement.

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

error_log( 'Ma valeur : ' . print_r( $my_variable, true ) );

Exploiter l’IA pour analyser les journaux

Une fois votre journal de débogage actif, vous pouvez aller plus loin en intégrant un agent d’intelligence artificielle dans votre processus de débogage.

Plutôt que de parcourir manuellement les logs et la documentation, vous pouvez demander à votre assistant d’analyser le fichier wp-content/debug.log. Il pourra identifier les erreurs, en comprendre l’origine et suggérer des corrections.

Que vous utilisiez Claude Code, Cursor ou Codex, le principe reste le même : indiquez simplement l’emplacement du journal. L’outil se charge ensuite de l’analyse, sans interrompre votre flux de travail.

Afficher les erreurs directement dans le navigateur

L’onglet Débogage propose également une option Afficher les erreurs dans le navigateur. Celle-ci active WP_DEBUG_DISPLAY et permet d’afficher les erreurs PHP directement dans la page.

Les erreurs fatales, avertissements et notices apparaissent alors dans le rendu HTML, ce qui facilite le développement sans avoir à consulter en permanence le fichier journal.

Important : l’option Afficher les erreurs dans le navigateur est à utiliser en complément du journal de débogage, et non en remplacement.

Elle est idéale en local pour un retour rapide, mais doit rester désactivée sur les sites accessibles à des tiers. L’affichage des erreurs peut en effet révéler des informations sensibles (chemins de fichiers, logique interne, etc.).

Un débogage plus efficace, des corrections plus rapides

Ces deux fonctionnalités répondent à des besoins différents :

• Le journal de débogage offre une solution simple pour enregistrer les erreurs et avertissements au fil de l’eau.
• Xdebug permet une analyse approfondie en mettant l’exécution en pause et en explorant le comportement du code.

Ensemble, elles font de WordPress Studio un environnement encore plus performant pour développer et corriger des sites WordPress en local.

Si vous n’avez pas encore essayé WordPress Studio, c’est le moment idéal pour vous lancer.