En el desarrollo de WordPress, localizar un bug a veces parece como buscar una aguja en un pajar. Sobre todo si utilizas llamadas var_dump() y revisas manualmente los registros de errores.
WordPress Studio incorpora dos nuevas funcionalidades para solucionar bugs que hacen que todo este proceso sea mucho más rápido e intuitivo: compatibilidad con Xdebug y acceso al registro de errores.
Soluciona errores paso a paso con Xdebug
Xdebug es la extensión de solución de bugs de PHP de referencia. En lugar de mostrar información sobre los errores en todo el código, puedes establecer puntos de interrupción, avanzar línea a línea por la ejecución e inspeccionar variables en tiempo real, todo desde el mismo editor.
Esta funcionalidad ya está disponible para todos los usuarios de Studio y funciona gracias a la versión WebAssembly de PHP de WordPress Playground, así que no tienes que instalar ni configurar nada más en tu sistema.
Activar Xdebug
- Selecciona el sitio en el que quieres buscar errores en Studio.
- Ve a la pestaña Configuración.
- Haz clic en Editar sitio.
- Ve a la pestaña Depuración.
- Marca la casilla Activar Xdebug.
- Haz clic en Guardar.
Studio reiniciará el sitio automáticamente con Xdebug activado.
Hay un par de cosas que conviene tener en cuenta:
- Xdebug solo puede estar activo en un sitio a la vez: para usar Xdebug en otro sitio, primero desactívalo en el que esté activo actualmente. En la barra lateral izquierda, aparecerá un icono de bug al lado del sitio que tiene Xdebug activado.
- Activar Xdebug ralentizará notablemente el rendimiento: es mejor activarlo solo cuando quieras solucionar bugs activamente.
Conectar tu IDE
Una vez que Xdebug esté activo, puedes conectar tu editor y empezar a buscar bugs para localizar el origen de cualquier problema, ya sea en plugins, temas o en el núcleo de WordPress. Studio busca conexiones de depuración en el puerto 9003.
Si quieres consultar la guía de configuración completa, visita la documentación de Xdebug en Studio.
Accede fácilmente a los registros de depuración
A veces, una herramienta de depuración paso a paso completa es más de lo que necesitas, especialmente si solo quieres ver lo que está registrando WordPress.
Studio te pone en bandeja una opción con un interruptor específico para el registro de errores, que configura automáticamente WP_DEBUG y WP_DEBUG_LOG en tus sitios.
Activar el registro de depuración en Studio
- Selecciona tu sitio y haz clic en Editar sitio.
- Abre la pestaña Depuración.
- Activa la opción Activar registro de depuración.
- Haz clic en Guardar.
Cuando el registro de depuración está activo, tu sitio local capturará errores, avisos y advertencias de PHP en un archivo de registro en wp-content/debug.log. Aparecerá el enlace Abrir archivo de registro en la pestaña Configuración, con el que podrás abrir el registro directamente, sin necesidad de buscar la ruta del archivo de forma manual.
También puedes escribir tus propios mensajes en el registro usando la función error_log() de PHP:
error_log( 'My value: ' . print_r( $mi_variable, true ) );
Esto resulta especialmente útil cuando necesitas echar un vistazo rápido a lo que ocurre durante la activación de un plugin, un callback de un hook o una petición a una API REST sin tener que configurar una sesión de depuración completa.
Utilizar agentes de IA para interpretar los registros de errores
Una vez que tu registro de depuración esté capturando errores y advertencias, puedes incorporar un agente de IA directamente en el proceso. En vez de tener que leer manualmente los resultados del registro y contrastarlos con la documentación, pásaselo todo a tu agente y deja que haga el trabajo duro.
La configuración es la misma con Claude Code, Cursor o Codex: dile a tu agente que los registros de errores están disponibles en wp-content/debug.log. Él se encargará de leer los resultados, identificar lo que está fallando y sugerir correcciones, todo sin interrumpir tu flujo de trabajo.
Mostrar errores en el navegador
La pestaña Depuración también incluye la opción «Mostrar errores en el navegador», que configura WP_DEBUG_DISPLAY y controla si los errores de PHP se muestran directamente en la página en lugar de capturarse en segundo plano en el registro.
Cuando está activo, los errores fatales, las advertencias y los avisos aparecen directamente en el HTML, lo que es útil durante el desarrollo activo para no tener que estar cambiando constantemente al archivo de registro.
Una nota importante: es mejor utilizar la opción «Mostrar errores en el navegador» a la vez que el registro de depuración, no como sustituto. Es ideal para hacer cambios rápidos en tu propio entorno local, pero es recomendable desactivarlo en cualquier sitio que compartas con clientes, ya que puede exponer información delicada sobre rutas o lógica interna en la página.
El hosting con superpoderes
Funciones avanzadas de rendimiento, seguridad y desarrollo en un solo lugar.
Descubre y corrige errores a la velocidad de la luz
Estas dos funcionalidades cubren diferentes aspectos del proceso de depuración local:
- El registro de depuración te ofrece una forma ligera de detectar errores y advertencias a medida que van surgiendo.
- Xdebug va un paso más allá, permitiéndote pausar la ejecución y examinar en detalle lo que está ocurriendo dentro del código.
Combinadas, hacen que Studio se convierta en un entorno más completo a la hora de desarrollar y solucionar problemas en sitios de WordPress locales.
Si todavía no has probado WordPress Studio, este es un buen momento para empezar.
WordPress.com en Español 
No utilices los comentarios para hacer preguntas, solicitar ayuda o informar de errores. Para ello ponemos a tu disposición nuestros foros o el formulario de contacto con el servicio de soporte.
Antes de publicar un comentario, lee nuestras normas sobre comentarios.