Xdebug dans WordPress Studio

Xdebug est une extension de débogage pour PHP qui vous permet de définir des points d’arrêt, d’inspecter des variables et de parcourir votre code pas à pas. WordPress Studio inclut la prise en charge de Xdebug, grâce à la version WebAssembly de PHP de WordPress Playground.

Activer Xdebug

1. Sélectionnez le site que vous souhaitez déboguer.
2. Accédez à l’onglet Réglages.
3. Cliquez sur « Modifier le site ».
4. Cochez la case « Activer Xdebug ».
5. Cliquez sur Enregistrer.

Le site redémarrera automatiquement avec Xdebug activé.

Limitations importantes

• Un seul site à la fois : Xdebug ne peut être activé que pour un seul site à la fois. Pour l’activer sur un autre site, vous devez d’abord le désactiver sur le site actuel.
• Impact sur les performances : Xdebug peut ralentir les performances du site. Désactivez-le lorsque vous ne déboguez pas activement.

Utiliser Xdebug avec votre IDE

Une fois Xdebug activé pour un site, vous pouvez connecter votre IDE (éditeur de code) pour déboguer les extensions, les thèmes et le code principal de WordPress.

Configuration de Visual Studio Code

1. Installez l’extension PHP Debug.
2. Créez un fichier .vscode/launch.json dans votre projet avec la configuration suivante :

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Listen for Xdebug",
      "type": "php",
      "request": "launch",
      "port": 9003,
      "pathMappings": {
        "/wordpress": "${workspaceFolder}"
      }
    }
  ]
}

3. Définissez des points d’arrêt dans votre code.
4. Lancez la session de débogage dans Visual Studio Code (Exécuter → Démarrer le débogage).
5. Accédez à votre site dans le navigateur pour déclencher les points d’arrêt.

Configuration de PhpStorm

1. Accédez à Réglages → PHP → Debug.
2. Vérifiez que le port Xdebug est défini sur 9003.
3. Pour ne pas s’arrêter à la première ligne :
   • Désactivez « Force break at first line when no path mapping specified »
   • Désactivez « Force break at first line when a script is outside the project »
4. Accédez à Réglages -> PHP → Servers et configurez le mappage pour le serveur de votre site :
   • Hôte : localhost:8884
   • Port : 80
   • Répertoire des fichiers : /Users/USERNAME/Studio/SITEDIR
   • Chemin absolu sur le serveur : /wordpress
5. Activez « Start listening for PHP Debug Connections » depuis la barre d’outils.
6. Définissez des points d’arrêt dans votre code.
7. Accédez à votre site dans le navigateur pour déclencher les points d’arrêt.

En savoir plus

Pour plus d’informations sur l’intégration de Xdebug, consultez la documentation WordPress Playground sur Xdebug.