Depuración de WordPress: la guía de todo lo que necesita saber

El eslabón más débil en cualquier proyecto de codificación eres tú . Es decir, el error humano es casi siempre una garantía, que surgirá en forma de errores y otros problemas. No querrá que ninguno de estos llegue a su sitio en vivo, por lo que la depuración de WordPress es un paso necesario durante su proyecto.

De hecho, WordPress incluye un modo de depuración propio, que puede ayudarte cuando trabajas con la plataforma. Si combina esto con su depurador fuera de la plataforma, tendrá un sistema robusto para atrapar cualquier cosa que aceche en la oscuridad.

Para esta publicación, veremos la depuración de 🔎 WordPress y le mostraremos cómo configurarla. Primero, sin embargo, veremos cómo difieren la depuración de WordPress y otros tipos de detección de errores. A partir de ahí, explicaremos por qué WordPress necesita su propio sistema de depuración antes de mostrarte cómo usarlo.

La diferencia entre la depuración de WordPress y la depuración de código general

Por supuesto, WordPress usa PHP para ejecutar casi todo bajo el capó, al igual que muchas otras aplicaciones web. Sin embargo, la depuración de WordPress puede ser diferente de la depuración de código general debido a su estructura y ecosistema específicos.

La principal diferencia entre la depuración de WordPress y la depuración de código general es cómo verá los errores. WordPress mostrará mensajes de error relacionados con la plataforma en la interfaz. Por el contrario, la depuración general del código a menudo ocurre dentro de la Terminal o de su editor de código dedicado:

Otra diferencia es el uso de funciones específicas de WordPress para ayudar con el proceso de depuración. WordPress proporciona su propio conjunto de funciones que utilizará para interactuar con el Sistema de gestión de contenido (CMS). Estas difieren de las funciones típicas de PHP y requerirán que adopte un enfoque específico para usarlas para la depuración.

En general, la diferencia entre la depuración de WordPress y la depuración general de código radica en la estructura específica y el ecosistema de WordPress. Como tal, deberá comprender la arquitectura de WordPress, junto con lo que ofrece la plataforma para depurar problemas de manera efectiva.

Por qué la depuración de WordPress requiere un proceso específico

WordPress no solo usa su PHP central. También ejecuta PHP externo en forma de temas y complementos. Si combina el desarrollo de terceros con la forma en que todos estos se conectan, podría introducir errores cuando combine todo el código. Como tal, WordPress ofrece sus propias herramientas de depuración para ayudar a eliminar estos problemas durante el desarrollo.

Otra área que deberá comprender (y que afecta por qué necesita una depuración de WordPress dedicada) es su estructura central de archivos y carpetas. La creación de un tema, por ejemplo, se basa en una jerarquía de plantillas que podría ser importante cuando realiza un escaneo de línea para encontrar el origen de un error.

Además, el diseño de WordPress se basa en una buena Experiencia de Usuario (UX). El proceso de depuración dedicado de WordPress tiene en cuenta la necesidad de informes de errores fáciles de usar. En lugar de utilizar complicados seguimientos de pila dentro de su editor de código, WordPress muestra un claro mensaje de error en la interfaz:

Hablando de UX, WordPress ofrece un conjunto de funciones personalizadas para ayudar a que su flujo de trabajo sea más eficiente y seguro. Como resultado, el proceso de depuración específico de WordPress significa que deberá comprender estas funciones y cómo interactúan con la plataforma.

En general, WordPress tiene un ecosistema complejo, un enfoque en UX y funciones personalizadas. Todo esto requiere su propio modo de depuración. En la siguiente sección, veremos cómo activar esto.

Cómo activar el modo de depuración de WordPress (y qué hace)

Puede activar el modo de depuración de WordPress a través del archivo wp-config.php . Tenemos una guía rápida sobre cómo hacer esto, y no debería llevarte más de un minuto más o menos. Sin embargo, hay algunos modos diferentes que querrá conocer y posiblemente usar:

• WP_DEBUG . Este es el modo de depuración básico en WordPress. Permite la depuración general dentro de la plataforma.
• WP_DEBUG_LOG . Este modo guarda todos los errores, advertencias y avisos de PHP en un archivo debug.log en el directorio wp-content . Es útil para identificar problemas difíciles de encontrar que no aparecen en la interfaz.
• WP_DEBUG_DISPLAY . Este modo muestra todos los errores, advertencias y avisos de PHP en la interfaz. Es útil para identificar problemas con temas y complementos, pero también puede mostrar mensajes para elementos que no parecen estar dañados. Por ejemplo, a menudo verá avisos sobre convenciones de validación de datos incorrectas.

Estas tres funciones pueden entrelazarse, por lo que deberá tener cuidado para usarlas de manera óptima y segura. Por ejemplo, a menudo querrá activar WP_DEBUG y WP_DEBUG_LOG para almacenar cualquier error en el archivo debug.log . Sin embargo, si no desactiva WP_DEBUG_DISPLAY , mostrar esos errores en la interfaz sería malo para UX.

También puede ir más allá de los comandos de pan y mantequilla y activar algunas otras constantes que cubrimos en otro artículo:

• SCRIPT_DEBUG . Por razones de rendimiento, WordPress usa archivos CSS y JavaScript minificados, pero estos pueden ser una pesadilla para depurar. Una vez que active SCRIPT_DEBUG , WordPress utilizará las versiones de desarrollo no optimizadas de los archivos en su lugar.
• SAVEQUERIES . Esto guarda todas las consultas de la base de datos en una matriz, lo que puede ayudarlo a identificar consultas lentas o ineficientes que afectan el rendimiento de su sitio.

WordPress no sería la plataforma que es sin sus complementos. Como tal, hay muchos complementos útiles para ayudar con la depuración de WordPress. A continuación, veremos algunos.

Uso de complementos de depuración de WordPress durante el desarrollo

Los complementos deben ser parte de su arsenal para ayudar a investigar errores. De hecho, la documentación oficial de WordPress sobre depuración incluye algunas opciones recomendadas.

Por ejemplo, Query Monitor le brindará información detallada sobre las consultas que ejecuta. Esta es una manera fantástica de ayudar a identificar las consultas que causan problemas de rendimiento.

La barra de depuración agrega un menú de depuración a la barra de administración de WordPress. Esto le permite acceder a la información de depuración en todo momento e incluye información detallada sobre errores de PHP, consultas de bases de datos y solicitudes HTTP.

Debido a que WordPress usa muchas funciones y constantes personalizadas, es probable que desee controlar si están en desuso. El complemento Registrar avisos obsoletos identifica (y registra) cualquier uso de funciones, ganchos o argumentos obsoletos en WordPress. Utilizará el complemento para ayudar a mantener su código actualizado con los últimos estándares de WordPress.

Sin embargo, hay muchos más complementos que puede instalar para ayudar con la depuración de WordPress. Una opción fantástica es Simply Show Hooks:

Este complemento le permite ver cada gancho que ejecuta una página. A menudo será un complemento de acceso, porque puede ver de un vistazo qué ganchos de WordPress usa una página, lo que reducirá su búsqueda inicial de un error.

Si desea encontrar un complemento que sea más una solución todo en uno, DebugPressco podría ser una buena opción:

Este complemento le brinda información de depuración en tiempo real, que incluye errores de PHP, consultas de bases de datos y solicitudes HTTP. También incluye una consola en tiempo real para monitorear errores del lado del servidor.

Es posible que desee semiautomatizar la instanciación inicial del modo de depuración de WordPress. Para esto es el excelente complemento de depuración de WP.

Te permite establecer estados predeterminados para todas las constantes de depuración disponibles sin necesidad de abrir el archivo wp-config.php . Los alternará a través de una activación y desactivación rápida dentro del menú de Complementos de WordPress.

Elegir complementos de depuración de WordPress

Cuando se trata de elegir complementos de depuración de WordPress, las métricas de calidad de los complementos, como la hora de la última actualización , son menos preocupantes. Esto se debe a que a menudo realizan tareas que no requieren una base de código actual constante.

Por ejemplo, Log Deprecated Notices tiene su última actualización en 2021. Sin embargo, a pesar de esto, sigue siendo un complemento recomendado para los desarrolladores de WordPress. Como tal, argumentamos que si el complemento funciona según lo previsto y no presenta más problemas, será bueno usarlo para fines de depuración.

Los beneficios de la supervisión del rendimiento de aplicaciones (APM)

Las herramientas de APM le permiten monitorear el rendimiento de las aplicaciones, lo que incluye el de los sitios web de WordPress. La información detallada de rendimiento incluye tiempos de respuesta, tasas de error y más.

Puede parecer que las herramientas de APM y la depuración no tienen mucho en común. Sin embargo, esto puede ayudarlo a mitigar parte del trabajo de depuración, según el escenario. Además, puede depurar primero y luego mantener ese rendimiento usando APM.

Cuando se trata de la depuración de WordPress, las herramientas APM tienen una serie de beneficios:

• Puede identificar cuellos de botella de rendimiento en su sitio web de WordPress. El análisis en tiempo real significa que puede identificar cualquier problema que pueda estar ralentizando su sitio web.
• Las herramientas de APM pueden ayudar a optimizar el rendimiento de su sitio. Esto le permite realizar mejoras específicas y mejorar el rendimiento en general.
• Al monitorear las métricas clave de rendimiento, puede identificar cualquier problema que pueda estar afectando la salud de su sitio web.
• Las herramientas de APM también pueden ayudar a identificar problemas de seguridad en su sitio web de WordPress. Al monitorear el tráfico y la actividad del sitio, puede detectar cualquier comportamiento inusual o sospechoso que pueda ser indicativo de un problema de seguridad.

Hay algunas herramientas de APM disponibles que se adaptan bien a WordPress. Por ejemplo, Kinsta tiene su propia herramienta APM, mientras que WP Engine integra el APM de New Relic en sus servicios.

En general, las herramientas de APM pueden ayudar a mejorar la UX de su sitio web de WordPress y tener un impacto en su trabajo de depuración. Si bien no es un sustituto, APM puede ayudarlo a determinar si las correcciones de errores son óptimas y dónde puede mejorar su código.

Consejos para ayudarte con la depuración de WordPress

Nuestro enfoque para esta publicación es la depuración de WordPress. Con esto en mente, ofreceremos seis consejos para ayudarlo a tener una mejor sesión de depuración.

1. Comience con un análisis de código estático
2. Apóyate en tus herramientas de depuración
3. Clasifica cada error que encuentres
4. Retroceda y realice búsquedas binarias para buscar todos los errores posibles
5. Ejecute un depurador después de cada nuevo conjunto de códigos
6. Busque resolver problemas en lugar de aplastar errores

1. Comience con un análisis de código estático

Un análisis de código estático es donde analiza el código sin ejecutarlo. Su objetivo es identificar posibles errores y vulnerabilidades. Puede hacer esto a través de un escaneo línea por línea, aunque una herramienta será más eficiente. PHP CodeSniffer o PHP Mess Detector funcionan bien aquí, y el primero también forma parte de las herramientas de edición de JetBrains.

Estas herramientas pueden ayudar a identificar violaciones de los estándares de codificación, código no utilizado y otros problemas potenciales que pueden afectar el rendimiento y la seguridad de su sitio web de WordPress. Por lo general, los instalará en su entorno de desarrollo y los ejecutará en su base de código. El informe generado describirá cualquier problema potencial. Esto le da una manera de identificarlos y arreglarlos.

Comenzar con un análisis de código estático le permite eliminar posibles problemas de raíz en una etapa temprana del proceso de desarrollo. Esto puede ayudar a garantizar que su sitio web de WordPress funcione bien, antes de que cualquier problema se vuelva más difícil y requiera más tiempo para solucionarlo.

2. Apóyate en tus herramientas de depuración

Hablando de herramientas de depuración, son casi esenciales independientemente de su idioma o plataforma CMS. Esto es especialmente cierto para WordPress, ya que hay una variedad de excelentes complementos para ayudarlo. Sin embargo, las herramientas de terceros fuera de la plataforma también proporcionarán valor.

En la mayoría de los casos, las herramientas de depuración te darán una comprensión más profunda de tu sitio. Esto le permitirá tomar decisiones más informadas cuando se trata de optimizar el rendimiento, mejorar la UX y mejorar la seguridad.

3. Clasifica cada error que encuentres

Una tarea administrativa de rutina con la depuración es clasificar cada error que encuentre. Esto puede ser útil para identificar la causa raíz de un problema y determinar la mejor solución.

Querrá considerar múltiples factores aquí, como la gravedad del problema, el impacto en UX y la complejidad de la solución. Por ejemplo, podría usar un sistema de niveles de gravedad, como crítico, mayor, menor o cosmético. Esto puede ayudar a priorizar qué errores abordar primero, en función de su impacto en la funcionalidad del sitio web y la experiencia de usuario.

Otra forma de clasificar los errores es usar categorías como usabilidad, funcionalidad o seguridad. Esto puede ayudar a identificar cómo el error afecta áreas específicas de su sitio web. A su vez, esto facilita la determinación de la causa raíz del problema y el mejor enfoque para solucionarlo.

Además, no necesita un sistema especial para almacenarlos: una hoja de cálculo funciona perfectamente. Incluso podría tener un sistema dentro de su editor de código o entorno de desarrollo integrado (IDE), como la codificación de colores.

4. Retroceda y realice búsquedas binarias para buscar todos los errores posibles

El "retroceso" es donde vuelve sobre sus pasos para identificar dónde apareció primero un error. Puede mirar cambios de código recientes, probar bases de código anteriores o revisar sus registros. Esta es una buena manera de agilizar el proceso de depuración para asegurarse de abordar todos los posibles problemas.

Del mismo modo, las búsquedas binarias pueden ser una técnica útil para la depuración de WordPress, especialmente cuando se trata de problemas complejos. Esto implica probar diferentes partes del código base de forma sistemática para identificar la ubicación del error. Puede aislar secciones específicas del código, ejecutar pruebas y luego pasar a la siguiente sección para reducir aún más el problema.

Esta es una forma eficiente de identificar errores y descubrir cómo solucionarlos. Es probable que ahorre tiempo y esfuerzo en comparación con enfoques de depuración más desordenados. Aún mejor, este podría ser un mejor enfoque para bases de código más grandes o problemas más complejos.

Sin embargo, una búsqueda binaria requiere un enfoque metódico y organizado para probar y evaluar todos los posibles problemas. Como tal, la documentación es importante, ya que le permite reproducir y corregir fácilmente cualquier problema que identifique.

5. Ejecute un depurador después de cada nuevo conjunto de códigos

Al igual que guardar los cambios a intervalos regulares, también debe acostumbrarse a ejecutar un depurador después de cada conjunto de códigos completo. Por supuesto, querrá asegurarse de que el código funcione como pretende antes de continuar.

Uno de los grandes beneficios aquí es que no tendrás errores persistentes dando vueltas. Esto puede ayudar a evitar que los problemas se multipliquen y se vuelvan más difíciles de solucionar a medida que avanza el desarrollo.

Sin embargo, este enfoque puede consumir tiempo, especialmente para bases de código grandes o problemas no críticos. Debido a esto, puede limitar la ejecución de un depurador solo a cambios de código críticos o para áreas más problemáticas de su base de código.

6. Busque resolver problemas en lugar de aplastar errores

Cuando se trata de la depuración de WordPress, puede ser útil cambiar su enfoque de simplemente "aplastar errores" a resolver problemas. Esto significa adoptar un enfoque más proactivo para identificar y abordar los problemas, en lugar de simplemente reaccionar ante los errores a medida que ocurren.

Para comenzar, busque la causa raíz del problema, luego trabaje para abordar esa causa, en lugar de simplemente solucionar los síntomas inmediatos del problema. Esto puede implicar volver a trabajar en ciertas secciones del código base o adoptar nuevas prácticas de desarrollo para evitar que ocurran problemas similares en el futuro.

Este enfoque puede mejorar la calidad general y la confiabilidad de sus proyectos, reducir la probabilidad de problemas futuros y mejorar la UX. Además, este enfoque puede ayudarlo a identificar áreas de mejora en su proceso de desarrollo, lo que conducirá a prácticas de desarrollo más eficientes y efectivas.

Conclusión 🧐

En definitiva, la depuración de WordPress utilizará la plataforma para reportar errores de código que afecten su funcionamiento. Además, utilizará algunos complementos dedicados en la mayoría de los casos para alertarlo sobre problemas. De hecho, las opciones que tiene para depurar WordPress pueden funcionar junto con sus herramientas de depuración típicas, como Xdebug.

La buena noticia es que no tienes un proceso de integración torpe cuando se trata de WordPress. Puede trabajar con el archivo wp-config.php y activar el depurador (e iniciar sesión) con valores booleanos. Esto mostrará cualquier error asociado junto con más detalles de los que obtendría a menudo. A partir de ahí, puede trabajar para corregir errores y hacer que su sitio esté casi terminado.

¿Tiene alguna pregunta sobre la depuración de WordPress o cualquier escenario con el que se haya encontrado? ¡Háganos saber en la sección de comentarios!