Cómo depurar WordPress

Este artículo describe algunas de las configuraciones que puede utilizar para depurar WordPress.

En general, estas configuraciones están destinadas a los desarrolladores y no deben utilizarse en un sitio de «producción».

Sin embargo, pueden utilizarse en algunos escenarios para solucionar problemas con código de terceros, como plugins o temas.

Para activar el modo de depuración en WordPress, siga estos pasos

• Inicie sesión en cPanel o utilice SSH para acceder a su cuenta.
• Utilizando el gestor de archivos de cPanel o el símbolo del sistema SSH, abra el archivo wp-config.php en su editor de texto favorito.
• Para activar el modo de depuración, añada la siguiente línea a su archivo wp-config.php
• define(‘WP_DEBUG’, true).
• Si este ajuste está activado, WordPress mostrará todos los errores, notificaciones y advertencias de PHP.
• Guarde los cambios y salga del editor de texto. El modo de depuración está activado.

Cuando haya terminado, desactive el modo de depuración cambiando la siguiente línea en su archivo wp-config.php

define(‘WP_DEBUG’, false).

Opciones adicionales para depurar en WordPress

Puede configurar una serie de ajustes adicionales para controlar la información de depuración proporcionada por WordPress.

WP_DEBUG_LOG.

Cuando WP_DEBUG_LOG y WP_DEBUG están activados, WordPress almacena toda la información de error en un archivo debug.log ubicado en el directorio wp-content. Por defecto, este ajuste está desactivado.

Para activar esta configuración, añada la siguiente línea a su archivo wp-config.php

define('WP_DEBUG_LOG', true) ;

WP_DEBUG_DISPLAY

Si WP_DEBUG_DISPLAY y WP_DEBUG están activados, WordPress mostrará mensajes de error y advertencia en sus páginas web. Por defecto, este ajuste está activado. Si este ajuste está desactivado, no se mostrarán mensajes de depuración.
Para desactivar esta configuración, añada la siguiente línea a su archivo wp-config.php

define('WP_DEBUG_DISPLAY', false) ;

SCRIPT_DEBUG

Cuando SCRIPT_DEBUG está activado, WordPress utilizará la versión de desarrollo de los archivos CSS y JavaScript principales en lugar de la versión comprimida. Por defecto, este ajuste está desactivado. Esta configuración puede utilizarse para probar los cambios en los archivos .js y .css incrustados.
Para activar esta configuración, añada la siguiente línea a su archivo wp-config.php

define('SCRIPT_DEBUG', true);

Registro de consultas a la base de datos

Si tiene problemas con la base de datos de WordPress, puede activar el registro de consultas. Cuando el registro de consultas está activado, lo siguiente se almacena en la matriz global $wpdb->queries

• La consulta real de la base de datos.
• El tiempo que se ha tardado en ejecutar la consulta.
• La función que llamó a la consulta.
• Para activar el registro de consultas a la base de datos, añada la siguiente línea a su archivo wp-config.php

define('SAVEQUERIES', true)

La activación de esta configuración afectará al rendimiento de su sitio.

Sólo debe activar esta configuración durante el tiempo necesario para depurar un problema, después de lo cual debe desactivarse.

El siguiente código PHP muestra cómo mostrar el contenido completo de la tabla $wpdb->queries en una página

Documentación oficial para depurar en WordPress

La documentación oficial sobre la depuración de WordPress se encuentra en https://codex.wordpress.org/Debugging_in_WordPress