Barra de herramientas de depuración de WordPress
Este artículo explica cómo activar el modo de depuración de WordPress y generar el archivo debug.log. Probablemente ha encontrado este artículo porque está experimentando un error fatal o una página blanca en blanco en su sitio de WordPress. Puede usar WP STAGING para prevenir estos errores fatales en su sitio de producción.
Puede obtener un error 500 o una página en blanco cuando abre su sitio web de WordPress. Para determinar qué plugin o código está causando ese error, puede decirle a WordPress que escriba todos los errores en un archivo de registro llamado debug.log o que los muestre en la pantalla en lugar de mostrar sólo la página blanca en blanco.
Por favor, tenga en cuenta cuando utilice el paso siguiente: Puede ver los mensajes de error de PHP en el front-end y en sus visitantes. Si ya no necesita que se muestren los errores por razones de seguridad, asegúrese de volver a poner el valor “false”.
Ya lo hemos mencionado antes, pero si estás investigando los problemas del sitio web de WordPress con el modo de depuración, no lo dejes activado todo el tiempo. Después de usar el debug.log, borre el archivo y desactive el registro de errores cambiando las siguientes líneas de define( ‘WP_DEBUG’, true ); a define( ‘WP_DEBUG’, false );.
WordPress escribe en el registro de depuración
El siguiente código, insertado en su archivo wp-config.php, registrará todos los errores, avisos y advertencias en un archivo llamado debug.log en el directorio wp-content. También ocultará los errores para que no interrumpan la generación de la página.
Nota: Los valores true y false en el ejemplo no están rodeados de apóstrofes (‘) porque son valores booleanos (verdadero/falso). Si establece las constantes como ‘false’, se interpretarán como true porque las comillas hacen que sea una cadena en lugar de un booleano.
Activar WP_DEBUG hará que se muestren todos los errores, avisos y advertencias de PHP. Esto es probable que modifique el comportamiento por defecto de PHP que sólo muestra los errores fatales y/o muestra una pantalla blanca de la muerte cuando se alcanzan los errores.
Mostrar todos los avisos y advertencias de PHP a menudo resulta en mensajes de error para cosas que no parecen rotas, pero que no siguen las convenciones de validación de datos apropiadas dentro de PHP. Estas advertencias son fáciles de arreglar una vez que el código relevante ha sido identificado, y el código resultante es casi siempre más resistente a los errores y más fácil de mantener.
La depuración de WordPress no funciona
En la mayoría de los casos, somos bastante rápidos a la hora de identificar la causa de un problema que nos comunique. Sin embargo, todavía existe la posibilidad de que los errores se produzcan debido a un conflicto con otro plugin o una configuración del servidor.
Este tipo de problemas no muestran un mensaje de error en muchas configuraciones por defecto. Así que para saber más, puede intentar activar el modo de depuración de WordPress. Este registrará o mostrará los errores en PHP, el principal lenguaje utilizado para desarrollar WordPress y Advanced Ads.
El Query Monitor no crea un registro por sí mismo. Si ves una advertencia que pueda estar relacionada con Advanced Ads, por favor, adjunta una captura de pantalla de la pestaña de errores de PHP y una copia del texto a un correo electrónico y envíamelo.
“WP Debug” es un método para mostrar o registrar los errores de PHP que de otro modo permanecerían ocultos. Para habilitarlo, necesitas acceder a los archivos de tu servidor. Utilice “WP DEBUG LOG” para mostrar los errores y registrarlos en un archivo que pueda inspeccionar más tarde.
Ahora vuelve a tu archivo wp-config.php y desactiva WP_DEBUG. También puedes decidir mantenerlo activado si estás trabajando en un entorno de desarrollo o mantener el registro durante un tiempo para detectar errores con otros plugins o temas que aún no conoces.
Plugin de depuración de WordPress
Tanto si eres un desarrollador, como si eres el propietario de un sitio que está solucionando un problema con tu sitio, entender la constante WP_DEBUG_LOG para activar el registro de depuración de WordPress es muy importante. En este post, cubriré cómo se usa WP_DEBUG_LOG, cómo encontrar errores ocultos, y por qué no recomendamos plugins de depuración de WordPress de terceros.
Te ahorraré el detalle línea por línea, pero esencialmente si estableces tanto WP_DEBUG como WP_DEBUG_LOG a true, y estableces WP_DEBUG_DISPLAY a false, el efecto será que obtendrás errores registrados en un archivo debug.log en tu carpeta wp-content y ninguna información de depuración de WordPress será mostrada en la salida de PHP (es decir, en tu navegador).
Si echa un vistazo al código de la función wp_debug_mode() de arriba, el último bloque de código se asegura de que no se muestre ningún error mientras se procesa una petición XML-RPC, WP-REST-API o admin-ajax.php. En esta época en la que los plugins se desarrollan con tecnologías como React o Svelte para sus frontales, es fundamental que seas capaz de detectar errores durante las peticiones Ajax y REST-API al backend de WordPress.