Depuración en Studio

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

WordPress Studio incluye varias herramientas integradas para ayudarte a encontrar y solucionar problemas en tus sitios locales de WordPress, sin necesidad de instalar software adicional ni salir de la aplicación.

Registro de depuración

A veces solo necesitas ver lo que WordPress está registrando. Studio lo facilita con un interruptor dedicado de registro de depuración que configura WP_DEBUG y WP_DEBUG_LOG para tu sitio automáticamente.

Habilitar el registro de depuración

1. Selecciona el sitio que deseas depurar.
2. Navega a la pestaña Settings.
3. Haz clic en «Edit site«.
4. Abre la pestaña Debugging.
5. Activa Enable debug log.
6. Haz clic en Save.

Cuando el registro de depuración está habilitado, tu sitio capturará errores, avisos y advertencias de PHP en wp-content/debug.log. Aparecerá un enlace Open log file en la pestaña Settings, para que puedas acceder directamente al archivo sin tener que buscar su ruta.

También puedes escribir tus propios mensajes en el registro usando la función error_log() de PHP:

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

Mostrar errores en el navegador

La pestaña Depuración también incluye un interruptor Mostrar errores en el navegador, que configura WP_DEBUG_DISPLAY. Cuando está activado, los errores y advertencias de PHP se imprimen directamente en la salida de la página en lugar de capturarse silenciosamente en el archivo de registro — útil cuando quieres retroalimentación inmediata durante el desarrollo activo.

Ten en cuenta:

• Mostrar errores en el navegador funciona mejor junto con el registro de depuración, no como un reemplazo del mismo.
• Desactívalo en cualquier sitio que compartas con clientes — puede exponer información de rutas internas u otros detalles de implementación en la salida de la página.

Uso de agentes de IA para interpretar registros de depuración

Una vez que tu registro de depuración esté activo, puedes dirigir un agente de IA directamente a él. Indica a tu agente — ya sea que estés usando Claude Code, Cursor u otra herramienta — que los registros de errores están disponibles en wp-content/debug.log. A partir de ahí, puede leer la salida, identificar qué está fallando y sugerir correcciones sin interrumpir tu flujo de trabajo.

Acceso a la base de datos con phpMyAdmin

Inspeccionar o editar tu base de datos local solía requerir una herramienta separada y una configuración aparte. Studio incluye acceso a phpMyAdmin directamente desde la pestaña Resumen — para que puedas consultar tablas, verificar datos y depurar problemas de esquema sin salir de la aplicación ni configurar nada.

Para abrir phpMyAdmin para un sitio, selecciona el sitio y haz clic en el botón phpMyAdmin en la pestaña Resumen.

Depuración paso a paso con Xdebug

Para una investigación más profunda, Studio incluye soporte para Xdebug. En lugar de dispersar salida de depuración por tu código, puedes establecer puntos de interrupción, avanzar paso a paso por la ejecución línea por línea e inspeccionar variables en tiempo real — todo desde tu editor.

Xdebug está disponible para todos los sitios de Studio y no requiere instalación a nivel de sistema. Studio escucha conexiones de depuración en el puerto 9003.

Para obtener instrucciones completas de configuración, incluyendo cómo conectar VS Code y PhpStorm, consulta Xdebug en Studio.