Qué es WordPress Debug (WP_DEBUG): una guía completa
access_time
hourglass_empty
person_outline

Qué es WordPress Debug (WP_DEBUG): una guía completa

Activar WordPress Debug (WP_DEBUG) en tu sitio de WordPress puede darte una mejor comprensión de lo que está sucediendo en él, especialmente cuando hay un problema. También es beneficioso para cualquier desarrollador de temas o de plugins que quiera que su producto sea promocionado públicamente por WordPress.

Así que, en este artículo, te mostraremos todo lo que necesitas saber sobre WP_DEBUG y cómo puedes utilizarlo para el desarrollo de tu sitio web.

¿Qué significa «debugging» o «debug»?

Debugging, en español es depuración, y significa identificar y eliminar errores o problemas en tu código. El último paso de hacer debugging es probar la corrección del código y asegurarte de que el problema no vuelva a ocurrir.

Esto es realizado principalmente por desarrolladores que usan herramientas de depuración, y es parte de una rutina en la etapa de desarrollo de software.

El proceso de depuración se puede hacer usando estrategias como prueba unitaria, revisión de código y programación de pares.

Entonces, antes de que el código o el software se publique a los usuarios, los desarrolladores intentarán encontrar cualquier problema, luego lo aislarán y lo solucionarán.

A veces, arreglar el código puede ser un verdadero dolor de cabeza, ya que puede llevar más tiempo que escribir el código en sí.

¿Por qué es importante WP_DEBUG?

WordPress Debug es una constante de PHP que activa el modo de depuración en WordPress. Puedes encontrarlo dentro de tu archivo wp-config.php. Si bien este modo está deshabilitado de forma predeterminada, puedes realizar muchas tareas importantes una vez que esté habilitado.

Primero, te dará información sobre cómo reproducir un problema. Al guardar un archivo de registro, registra todas las actividades que ocurren en tu sitio y eso puede ayudarte a solucionar un problema.

En segundo lugar, WP_DEBUG mostrará una lista de funciones obsoletas en el tema de WordPress o lanzamientos de plugins. Estas son funciones que estarán marcadas como inactivas en el futuro. Esta función también te permite saber qué alternativas se pueden utilizar en su lugar.

Otra razón importante para habilitar WordPress Debug está asociada a la creación de un tema o plugin.

WordPress Codex recomienda que todos los desarrolladores utilicen WP_DEBUG al crear su producto, de modo que cuando haya un problema o una advertencia, otro desarrollador pueda inspeccionar y corregir el código.

Si no es compatible con WP_DEBUG, la biblioteca oficial de herramientas de WordPress no respaldará tu complemento o tema.

Usos prácticos de WP DEBUG

Habiendo explicado la idea general de qué es WordPress Debug, ahora vamos a cubrir el uso práctico.

WP_DEBUG

WP_DEBUG se encuentra en el archivo wp-config.php y por defecto tiene el valor establecido en «falso«. Si deseas habilitarlo, debes cambiarlo a «verdadero«. Para hacerlo, necesitarás un cliente FTP, como FileZilla o un administrador de archivos para acceder al archivo.

En nuestro ejemplo, utilizaremos el Administrador de archivos de Hostinger.

  1. Busca el archivo wp-config.php en la carpeta raíz de tu sitio web. En nuestro ejemplo, está en hostinger-dev-9.xyz/public_html/wp-config.php.
    ubicación del archivo wp-config.php
  2. Ábrelo y busca
    define ('WP_DEBUG', falso)

    Cómo habilitar WP_DEBUG

  3. Una vez localizado, cambia false por true. Luego, guarda el archivo.

Si no encuentras este código en tu archivo wp-config.php, puedes agregarlo encima de la línea «/* That’s all, stop editing! Happy blogging. */«.

Ten en cuenta que la depuración no debe habilitarse en un sitio web que está online porque este modo está diseñado solo para fines de desarrollo.

WP_DEBUG_LOG

Al habilitar WP_DEBUG_LOG, los usuarios pueden guardar todos los errores en un archivo debug.log. Esta función trabaja de la mano con WP_DEBUG y puede ayudar a reproducir problemas para su resolución.

Para habilitarlo, abre el archivo wp-config.php e ingresa la siguiente línea debajo de define (‘WP_DEBUG’, true);

define ('WP_DEBUG_LOG', true);

Cómo habilitar WP_DEBUG_LOG

Después de activar la función, el archivo debug.log se guardará automáticamente en la carpeta /wp-content/ de tu sitio web. Puedes ver directamente el archivo en tu navegador.

ubicación del archivo debug.log dentro del directorio de WordPress

WP_DEBUG_DISPLAY

Debes deshabilitar WP_DEBUG_DISPLAY para que los mensajes de error no se muestren en tu sitio web.

De forma predeterminada, cada vez que hay un error, se generará y se mostrará dentro de tu código HTML. Y a diferencia de WP_DEBUG, el valor original es «true» y debes cambiarlo a «false» para ocultar todos los errores.

O si no está disponible, debes insertar esta línea en el archivo wp-config.php, justo debajo de define («WP_DEBUG», true);.

define ('WP_DEBUG_DISPLAY', false);

Cómo ocultar todos los errores deshabilitando WP_DEBUG_DISPLAY

Todas estas características: WP_DEBUG, WP_DEBUG_LOG y WP_DEBUG_DISPLAY se pueden usar al mismo tiempo para habilitar la depuración, guardar un archivo de registro y ocultar todos los errores.

7 consejos para depurar problemas en WordPress

Cuando tu sitio de WordPress se bloquea o tiene la pantalla blanca de la muerte (WSoD), la acción común es desactivar los complementos/temas y verificar las actualizaciones.

Si bien eso es útil para buscar al culpable, puede llevar mucho tiempo, ser ineficiente y también puede dejar que el problema real pase desapercibido. Es por eso que tener las herramientas adecuadas puede ser un verdadero cambio en el juego.

1. Activa WP_DEBUG

La activación de WP-DEBUG es probablemente la forma más sencilla de registrar problemas en un sitio de WordPress. Pero desafortunadamente, algunos desarrolladores no hacen esto, probablemente porque olvidan que esta característica existe.

Lo repetimos nuevamente, esta vez de una forma resumida, WP_DEBUG es una constante que activa el modo «debug» en WordPress, y puedes encontrarla en el archivo wp-config.php. Esta constante puede registrar todas las actividades en tu sitio y ayudarte a solucionar cualquier problema.

Hemos cubierto instrucciones más detalladas sobre WP_DEBUG más arriba.

2. Habilita el Informe de errores de WPDP

Para detectar cualquier problema relacionado con la base de datos, puedes habilitar el informe de errores WPDP.

El objeto global $wpdb tiene una variable llamada $show_errors. Y si la configuras como verdadero (true), puedes hacer que WordPress muestre los errores de SQL en la pantalla para cualquier consulta.

Para habilitar esto, ve a /public_html/wp-includes/wp-db.php y abre el archivo. Busca wpdb class y cambia la variable $show_errors a true.

Cambiando la variable $show_errors a true

3. Verifica los registros de errores de tu sitio web

A veces, puedes encontrar la página de errores del servidor de intervalos cuando navegas por tu sitio. Y para solucionar este problema, puedes revisar los registros de errores de tu sitio web.

Hacer un chequeo general del registro puede ayudar a los desarrolladores principiantes y avanzados a detectar el problema del sitio web.

Luego puedes usar la búsqueda de Google para buscar una posible solución.

4. Usa el entorno de pruebas de WordPress cuando modifiques tu código

Si deseas minimizar los errores en tu sitio de WordPress, puedes hacerlo implementando primero el código en un sitio staging.

Un sitio staging es casi un clon exacto de tu sitio web en vivo y se puede alojar en tu subdominio privado. Este sitio actúa como un terreno de desarrollo para cualquier código que desees implementar en tu sitio en vivo.

Este entorno no es visible para visitantes ni motores de búsqueda. Para que puedas tener más libertad de ajustar y probar los cambios que deseas implementar, sin afectar tu sitio público en vivo.

5. Habilita SCRIPT_DEBUG

De forma predeterminada, WordPress utiliza la versión reducida de los archivos CSS y JavaScript para ayudar a mejorar el tiempo de carga de tu sitio. Sin embargo, esto puede ser un problema porque puedes ocultar errores en los scripts/plugins que utilizas.

Para cambiar la ejecución del script, WordPress también proporciona una constante que podemos agregar al archivo wp-config.php, es decir:

define( 'SCRIPT_DEBUG', true );

Habilite SCRIPT_DEBUG en wp-config.php

Cuando el valor esté definido como verdadero, WordPress cargará automáticamente las versiones no minimizadas de todos los archivos CSS y JavaScript, haciendo que todos los complementos utilicen su versión completa.

6. Detecta errores de PHP

Puedes detectar los errores de PHP temprano en tus scripts usando phpinfo. Este archivo puede generar información sobre el estado actual de PHP, incluidas las opciones y extensiones de compilación, el entorno, la versión del sistema operativo, los encabezados HTTP y la licencia.

Para hacerlo, puedes configurar el archivo php.ini para habilitar el informe de errores. Sin embargo, algunos servicios de alojamiento, incluido el plan de alojamiento compartido de Hostinger, deshabilitan esta opción.

Esto se debe a que no tienes acceso root para habilitar la función.

Pero, en su lugar, puedes usar el verificador de código PHP, que te proporciona un asistente sencillo para revisar los errores en tu código. Y para una revisión más exhaustiva, también puedes usar IDEs como Eclipse o PHPStorm.

7. Aproveche algunas herramientas de depuración

Si necesitas simplicidad para monitorear errores en tu sitio de WordPress, también puedes aprovechar los plugins de depuración de WordPress.

1. Query Monitor

Monitor de consultas para depurar WordPress

Este plugin proporciona un panel de herramientas para desarrolladores en WordPress. Puedes habilitar consultas de bases de datos, errores PHP, llamadas API HTTP, enlaces y acciones, detener bloques del editor, scripts en cola y hojas de estilo, y más.

Alternativamente, también puedes usar Debug Bar y Simply Show Hooks para ayudarte a depurar tu sitio de WordPress. Sin embargo, estos dos plugins pueden tener problemas de compatibilidad con la versión más reciente de WordPress.

2. New Relic

New Relic aplicacion de monitoreo para depurar WordPress

También puedes realizar una depuración más robusta utilizando una herramienta premium como New Relic. Esta aplicación te ayudará a monitorear la experiencia del usuario, mapear la arquitectura de WordPress, analizar y mejorar el rendimiento del sitio, y detectar anomalías antes de que sucedan.

Todas esas características te ayudarán a recopilar datos para la resolución de problemas para que puedas proporcionar la mejor experiencia posible a los visitantes. Puedes probar New Relic por 14 días gratis.

Conclusión

Comprender cómo usar WordPress Debug tiene muchos beneficios importantes para los propietarios y desarrolladores de sitios WordPress por igual. Puedes usarlo para habilitar el modo de depuración y guardar u ocultar todos los errores para un mejor desarrollo del sitio web. Además, el proceso es bastante fácil.

Aquí hay un resumen de todos los pasos para utilizar WP_DEBUG, WP_DEBUG_LOG y WP_DEBUG_DISPLAY:

  • WP_DEBUG – Encuentra el archivo wp-config.php y cambia define (‘WP_DEBUG’, false); a true.
  • WP_DEBUG_LOG – Añade define (‘WP_DEBUG_LOG’, true); bajo la línea define («WP_DEBUG», true);.
  • WP_DEBUG_DISPLAY – Ingresa define (‘WP_DEBUG_DISPLAY’, false); bajo la línea con define («WP_DEBUG», true); línea.

También te dejamos un resumen de los tips que puedes aplicar para depurar tu sitio WordPress:

  • Activar WP_DEBUG
  • Habilitar informe de errores de WPDP
  • Verificar los registros de errores de tu sitio web
  • Usar el entorno de ensayo de WordPress cuando modifiques tu código
  • Habilitar SCRIPT_DEBUG
  • Detectar errores de PHP
  • Utilizar herramientas de depuración como el Query Monitor o New Relic

Si tienes alguna pregunta, contáctanos en la sección de comentarios.

El Autor

Author

Deyimar A. / @deyimar

Deyi es una entusiasta del marketing digital, con experiencia en diseño de páginas web, creación de contenido, copywrite y SEO. Forma parte del equipo de SEO & Localization de Hostinger. En su tiempo libre, le gusta desarrollar proyectos, leer un libro o ver una buena película.

Tutoriales relacionados

Agregá un comentario

Comentario*

Nombre*

Email*

Este sitio usa Akismet para reducir el spam. Aprende cómo se procesan los datos de tus comentarios.

¡Formá parte de Hostinger ahora!