En un mundo perfecto, nunca tendrías un solo problema que requiriera ser depurado. Pero en el mundo real, es casi seguro que te toparás con algo que requiera una mirada bajo el capó.

Para ayudarte a hacerlo, WordPress incluye su propio modo de depuración incorporado y también puedes encontrar útiles herramientas de terceros para ayudarte a depurar WordPress.

En este post, profundizaremos en el modo de depuración incorporado de WordPress y te mostraremos cómo activarlo. Luego, también compartiremos algunas de las otras formas en las que puedes depurar tu sitio de WordPress.

Aquí está todo lo que cubriremos:

¿Qué hace WP Debug?

El núcleo del software de WordPress está escrito en PHP, al igual que los plugins y los temas.

Si tienes problemas con tu sitio, el modo de depuración de WordPress puede ayudarte a descubrir qué es lo que va mal mostrando todos los errores, avisos y advertencias de PHP.

Una vez que habilites el modo de depuración, verás mensajes como este siempre que haya un problema (incluso si no está causando problemas inmediatos):

WP_DEBUG ejemplo de error en el sitio de WordPress

WP_DEBUG ejemplo de error en el sitio de WordPress0

Entonces puedes arreglar el problema o reportarlo a tu desarrollador o al desarrollador del tema/plugin.

¿Qué es el registro de depuración de WordPress?

Cuando habilites el modo de depuración de WordPress por sí mismo, verás mensajes como el ejemplo anterior en tu sitio por el momento, pero esos mensajes no se guardarán en ningún sitio.

Si quieres guardarlos, también puedes activar el registro de depuración de WordPress para guardar todos esos mensajes y errores en un archivo de tu servidor.

Cuando se habilita estableciendo la constante WP_DEBUG_LOG a true, WordPress escribirá todos los números en el siguiente archivo:

wp-content/debug.log

Sin embargo, también puede especificar una ruta de archivo personalizada para escribir el registro en una ubicación diferente de su servidor.

Si quieres guardar los problemas en el registro pero no mostrarlos públicamente dentro del HTML de tus páginas (como en la captura de pantalla de ejemplo anterior), también puedes usar la constante WP_DEBUG_DISPLAY para mantener activado el modo de depuración pero no mostrar mensajes en tu sitio.

Típicamente, querrás combinar WP_DEBUG_DISPLAY WP_DEBUG_LOG.

¿Listo para depurar tu sitio #WordPress? Esta guía te ayudará contra los 🐛Click to Tweet

Cómo activar el modo de depuración de WordPress

Para activar el modo de depuración de WordPress, tienes varias opciones. Cubriremos tres métodos para habilitarlo:

Cómo activar el modo de depuración de WordPress en MyKinsta

Si alojas tu sitio de WordPress en Kinsta, hemos construido una herramienta sencilla que te permite habilitar el modo de depuración de WordPress sin necesidad de editar tu archivo wp-config.php.

Esta herramienta es conveniente para poder activar rápidamente el modo de depuración y mostrar mensajes en tu sitio, pero no te permite controlar el registro de depuración de WordPress o si mostrar o no los mensajes en las páginas en vivo. Si quieres usar sólo el registro de depuración, puede que prefieras el método de los plugins en la siguiente sección.

Para empezar:

Cómo activar el modo de depuración de WordPress en MyKinsta

Cómo activar el modo de depuración de WordPress en MyKinsta

Puedes usar la herramienta tanto en tu entorno en vivo como en el de la puesta en escena. Sin embargo, siempre que sea posible, le recomendamos que la utilice con su entorno de ensayo porque al activar el modo de depuración de WordPress podría mostrar a los visitantes detalles sobre el código PHP de su sitio (lo cual es confuso para los visitantes y también un riesgo para la seguridad).

Cuando termines, puedes desactivar el modo de depuración haciendo clic en el botón Desactivar de tu panel Kinsta:

Cómo desactivar el modo de depuración de WordPress en MyKinsta

Cómo desactivar el modo de depuración de WordPress en MyKinsta

Info

¿Le gustaría hacer una prueba a MyKinsta? Crea tu cuenta de demostración gratis y empieza a jugar con ella

Cómo usar un plugin de depuración de WordPress

Si no estás alojado en Kinsta, también puedes encontrar plugins de depuración de WordPress gratuitos que facilitan la activación del modo de depuración. Hay varias opciones en WordPress.org, pero recomendamos el plugin gratuito WP Debugging de Andy Fragen.

WP Debugging WordPress plugin

WP Debugging WordPress plugin

Una vez que instalas y activas el plugin, empieza a funcionar de inmediato. Por defecto, establece las siguientes constantes a true (es decir, habilita las siguientes características):

Cubriremos lo que las dos últimas constantes hacen un poco más tarde en este post.

Para configurar algunas opciones, puede ir a Herramientas → Depuración WP:

Configuración del plugin de depuración WP

Configuración del plugin de depuración WP

Una vez que hayas terminado, asegúrate de desactivar el plugin para desactivar el modo de depuración.

Cómo activar manualmente el modo de depuración de WordPress

Por último, también puedes activar el modo de depuración de WordPress añadiendo manualmente las constantes a tu archivo wp-config.php.

Para empezar, conéctese a su servidor por FTP y edite el archivo wp-config.php. Por defecto, este archivo se encuentra en la carpeta raíz de su sitio (a menos que lo haya movido por razones de seguridad).

Para activar sólo el modo básico de depuración de WordPress, añade el siguiente fragmento de código encima de la línea que dice /* Eso es todo, ¡deja de editar! Feliz blogging. */:

// Enable WP_DEBUG mode
define( 'WP_DEBUG', true );

También puede utilizar algunas de las siguientes constantes según sus preferencias:

// Enable Debug logging to the /wp-content/debug.log file
define( 'WP_DEBUG_LOG', true );
// Disable display of errors and warnings
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

Una vez que hayas terminado, puedes establecer las constantes en falso o simplemente eliminar el fragmento para desactivar el modo de depuración.

Asegúrate de desactivar el modo de depuración en WordPress cuando termines

El modo de depuración es útil cuando intentas solucionar problemas con WordPress, pero no deberías dejarlo activado 24/7 porque puede revelar el texto de tu código PHP a los visitantes del sitio web.

Ya lo hemos mencionado, pero esto es sólo un recordatorio para desactivar siempre el modo de depuración cuando termines de solucionar los problemas.

Otras formas de depurar WordPress

Además de la herramienta de depuración incorporada que hemos presentado anteriormente, hay otras herramientas incorporadas y de terceros que te ayudarán a depurar tu sitio de WordPress.

Depuración del guión

SCRIPT_DEBUG es otra constante incorporada que obliga a WordPress a usar las versiones de desarrollo de los archivos centrales de CSS y JavaScript en lugar de las versiones minificadas que suele cargar.

Esto puede ser útil si estás probando cambios en los archivos . js o . css incorporados.

¿Cansado de experimentar problemas con tu sitio de WordPress? Obtén el mejor y más rápido soporte de hosting con Kinsta! Consulta nuestros planes

Para habilitar SCRIPT_DEBUG, puedes hacer cualquiera de las dos cosasUse the free WP Debugging plugin from above, which enables it by default.

Depuración de consultas de la base de datos

Si tiene problemas con la base de datos de su sitio, puede habilitar el registro de consultas de la base de datos usando la constante SAVEQUERIES para rastrear:

Para habilitar el registro de consultas, puede

Nota: esto afectará al rendimiento de tu sitio, así que intenta usarlo en un sitio de montaje siempre que sea posible y desactívalo tan pronto como termines.

Plugin de monitor de consultas

El plugin Query Monitor es un plugin gratuito que es útil para depurar un número de áreas diferentes en WordPress, incluyendo:

En general, es una de las mejores herramientas de depuración de WordPress que encontrarás, por lo que tiene casi una perfecta calificación de 5 estrellas en más de 320 reseñas.

Una vez que instales y actives el plugin, obtendrás algunas nuevas opciones en la barra de herramientas de WordPress que muestran información de depuración. Al hacer clic en esas opciones, se abrirá un nuevo cuadro de Monitor de Consultas que te dará más información:

El plugin Query Monitor

El plugin Query Monitor

Para una mirada más detallada, tenemos un post completo sobre cómo usar el plugin Query Monitor.

New Relic

New Relic es una herramienta de primera calidad para analizar y depurar el rendimiento de su sitio. Puede ayudarte a descubrir los cuellos de botella y los problemas que afectan al rendimiento de tu sitio.

Kinsta incluye una integración incorporada para ayudarte a habilitar fácilmente New Relic para tu sitio de WordPress, pero aún así tendrás que comprar tu propia clave de licencia de New Relic.

Registros del servidor

Por último, los registros del servidor también pueden ser una herramienta útil para depurar WordPress.

Si te hospedas en Kinsta, puedes ver todos los registros de tu servidor desde la pestaña de registros en el panel de control de un sitio:

Viendo los registros del servidor en el tablero de MyKinsta

Viendo los registros del servidor en el tablero de MyKinsta

Si se hospeda en otro lugar, tendrá que consultar la documentación de su host para saber dónde puede acceder a los registros de su servidor.

Es hora de echar un vistazo bajo el capó y depurar tu sitio #WordPress 🐛 Esta guía tiene todo lo que necesitas para empezar 💪Click to Tweet

Resumen

Si necesita depurar WordPress, el modo de depuración de WordPress incorporado proporciona una forma útil de ver los errores y avisos de PHP.

Si te hospedas en Kinsta, puedes habilitarlo desde el tablero de mandos. De lo contrario, puede habilitarlo con plugins o añadiendo fragmentos de código al archivo wp-config.php de su sitio.

Para obtener más ayuda, también puedes usar otras herramientas incorporadas o de terceros como New Relic y el plugin gratuito Query Monitor.

¿Tienes alguna otra pregunta sobre cómo depurar WordPress? ¡Deja un comentario y háznoslo saber


Si le ha gustado este artículo, entonces le encantará la plataforma de Kinsta WordPress hosting. Acelere su sitio y reciba soporte 24/7 de nuestro equipo de WordPress veterano. Nuestra infraestructura potenciada por Google Cloud se centra en escalamiento automático, rendimiento y seguridad. ¡Déjenos mostrarle la diferencia con Kinsta! Conozca nuestros planes