En un mundo perfecto, nunca tendrías un solo problema que requiriera ser depurado. Pero en el mundo real, seguramente te encontrarás con problemas en tu sitio de WordPress que requieren 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:
- Una introducción al modo de depuración de WordPress y al registro de depuración
- Cómo habilitar el modo de depuración de WordPress (tres métodos)
- Algunas otras formas de depurar WordPress
¿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):
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.
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:
- Abre tu tablero de MyKinsta.
- Selecciona el sitio donde quieres habilitar la depuración en la lista de sitios.
- Ve a la pestaña de Herramientas en el tablero de ese sitio.
- Haz clic en Activar en la depuración de WordPress.
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 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.
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):
WP_DEBUG– habilita el modo de depuración.WP_DEBUG_LOG– guarda los mensajes en un archivo de registro.SCRIPT_DEBUGSAVEQUERIES
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:
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.
Para habilitar SCRIPT_DEBUG, puedes hacer cualquiera de las dos cosasUse the free WP Debugging plugin from above, which enables it by default.
- Utiliza el plugin gratuito WP Debugging de arriba, que lo habilita por defecto.
- Añade la siguiente constante a tu archivo wp-config.php –
define( 'SCRIPT_DEBUG', true );
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:
- Cada consulta de la base de datos.
- La función que llamó a la consulta de la base de datos.
- Cuánto tiempo tomó la consulta.
Para habilitar el registro de consultas, puede
- Utiliza el plugin gratuito WP Debugging de arriba, que lo habilita por defecto.
- Añade la siguiente constante a tu archivo wp-config.php –
define( 'SAVEQUERIES', true );
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 Query Monitor
El plugin Query Monitor es un plugin gratuito que es útil para depurar un número de áreas diferentes en WordPress, incluyendo:
- Consultas a la base de datos.
- Errores de PHP.
- Ganchos y acciones.
- Bloquea los bloqueos del editor.
- Guiones y hojas de estilo en cola.
- Llamadas HTTP API.
- Capacidades del usuario.
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:
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 ya incluye la herramienta APM integrada. Sin embargo, puedes seguir utilizando New Relic en el tablero de MyKinsa, siempre que tengas tu propia licencia.
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:
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.
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 (se requiere una licencia propia) y el plugin gratuito Query Monitor.
¿Tienes alguna otra pregunta sobre cómo depurar WordPress? ¡Deja un comentario y háznoslo saber
Jon es el Director de Operaciones de Kinsta y colabora a diario con los equipos de ventas, atención al cliente y soporte técnico de Kinsta. Jon es un hombre de familia. Así que cuando no está golpeando frenéticamente las teclas de su portátil, suele estar ayudando a uno de sus hijos a arreglar una bicicleta o configurando Netflix para un niño impaciente en edad preescolar.
Deja una respuesta