Xdebug en WordPress Studio

Este texto fue traducido usando IA. Si deseas ver el texto original en inglés, haz clic aquí.

Xdebug es una extensión de depuración para PHP que te permite establecer puntos de interrupción, inspeccionar variables y recorrer tu código paso a paso. WordPress Studio incluye soporte para Xdebug, impulsado por la versión WebAssembly de PHP de WordPress Playground.

Habilitar Xdebug

1. Selecciona el sitio que deseas depurar.
2. Navega a la pestaña Settings.
3. Haz clic en «Edit site«.
4. Marca la casilla «Enable Xdebug«.
5. Haz clic en Save.

El sitio se reiniciará automáticamente con Xdebug habilitado.

Limitaciones importantes

• Solo un sitio a la vez: Xdebug solo puede habilitarse para un único sitio a la vez. Para habilitarlo en un sitio diferente, primero debes deshabilitarlo en el sitio actual.
• Impacto en el rendimiento: Xdebug puede ralentizar el rendimiento del sitio. Deshabilítalo cuando no estés depurando activamente.

Usar Xdebug con tu IDE

Una vez que Xdebug esté habilitado para un sitio, puedes conectar tu IDE (editor de código) para depurar plugins, temas y código del núcleo de WordPress.

Configuración de Visual Studio Code

1. Instala la extensión PHP Debug.
2. Crea un archivo .vscode/launch.json en tu proyecto con la siguiente configuración:

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

3. Establece puntos de interrupción en tu código.
4. Inicia la sesión de depuración en Visual Studio Code (Run → Start Debugging).
5. Navega a tu sitio en el navegador para activar los puntos de interrupción.

Configuración de PhpStorm

1. Ve a Settings → PHP → Debug.
2. Verifica que el puerto de Xdebug esté configurado en 9003.
3. Para dejar de detenerse en la primera línea:
   • Desactiva «Force break at first line when no path mapping specified»
   • Desactiva «Force break at first line when a script is outside the project»
4. Navega a Settings -> PHP → Servers y configura el mapeo para el servidor de tu sitio:
   • Host: localhost:8884
   • Port: 80
   • File directory: /Users/USERNAME/Studio/SITEDIR
   • Absolute path on the server: /wordpress
5. Activa «Start listening for PHP Debug Connections» desde la barra de herramientas.
6. Establece puntos de interrupción en tu código.
7. Navega a tu sitio en el navegador para activar los puntos de interrupción.

Más información

Para obtener información adicional sobre la integración de Xdebug, consulta la documentación de Xdebug de WordPress Playground.