Herramientas nativas de depuración de WordPress que no requieren un IDE

Last updated Dic 3, 2022

Contenido

Herramientas de depuración nativas de WordPress

Si acaba de unirse a la membresía del sitio y está buscando contenido específicamente para The Independent WordPress Developer, le recomiendo leer la publicación anterior, como mínimo, para prepararse para el contenido de esta publicación.

Sin embargo, si desea ponerse al día con el artículo anterior, aquí hay una breve lista de todo lo que se ha escrito hasta ahora:

Mientras nos preparamos para pasar a hablar de temas más avanzados, como la depuración y los IDE, primero vale la pena señalar las herramientas que tenemos disponibles que podemos instalar dentro de WordPress que nos ayudarán con los problemas de depuración durante el desarrollo.

Además, estos problemas no están relacionados estrictamente con problemas de PHP. Estos también incluyen problemas de JavaScript. Y para ir un paso más allá, hay formas en las que podemos configurar WordPress de forma nativa para que envíe errores directamente a nuestro navegador.

Entonces, antes de analizar los registros de errores, IDE, Xdebug, etc., veremos qué podemos hacer dentro de WordPress.

Herramientas de depuración nativas de WordPress

Las herramientas de depuración nativas de WordPress son una combinación de dos cosas:

las opciones que podemos establecer en el archivo de configuración de WordPress que nos permiten ver información escrita en pantalla,
varios complementos que nos ayudarán a trabajar con archivos PHP y JavaScript desde el área de administración de WordPress

Para el segundo punto anterior, quiero dejar claro que hay muchos complementos disponibles para algo como esto; sin embargo, quiero mantener la instalación lo más sencilla posible para que no nos inunden con demasiada información.

En cambio, quiero que tengamos la información que necesitamos para probar y evaluar nuestro trabajo, pero que solo tengamos lo que necesitamos. Por ahora. Quizás hablemos de temas avanzados en futuras publicaciones.

Dicho esto, comencemos.

Configuración de WordPress

Antes de preocuparnos por la configuración, el propio WordPress proporciona algunas opciones diferentes que podemos configurar en el wp-config.phparchivo. Estos están bien documentados en el Codex, pero sé por la experiencia de los correos electrónicos de otros que la información puede ser un poco difícil de filtrar.

Primero, es importante tener en cuenta lo siguiente (citado en el Códice de WordPress):

WP_DEBUG es una constante de PHP (una variable global permanente) que se puede usar para activar el modo de "depuración" en WordPress. Se supone que es falso de forma predeterminada y, por lo general, se establece en verdadero en el archivo wp-config.php en las copias de desarrollo de WordPress.

Esto supone que entiendes las constantes de PHP. Si no, consulte el manual aquí (es bastante sencillo). El resumen es el siguiente:

Una constante es un identificador (nombre) para un valor simple.

Así que voy a hacer lo que pueda para proporcionar las opciones de configuración y destilarlo tanto como sea posible.

Primero, en el wp-config.phparchivo, querrá cambiar la línea que dice:

<?php
define( 'WP_DEBUG', false );

A esto :

<?php
define( 'WP_DEBUG', true );

Sin embargo, eso no es todo. Hay algunas cosas más para agregar que mejorarán la experiencia de depuración:

<?php
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', true );
@ini_set( 'display_errors', 1 );
define( 'SCRIPT_DEBUG', true );
define( 'SAVEQUERIES', true );

Si estás siguiendo el Pero, ¿qué significa cada línea? Aquí hay una explicación tan sucinta como puedo dar ahora mismo:

WP_DEBUG. Esto mostrará los errores y advertencias arrojados por PHP al ejecutar WordPress. La ejecución de la aplicación por sí sola no debería mostrar ningún problema; sin embargo, ejecutarlo junto con varios complementos puede ser una historia diferente según la calidad del complemento.
WP_DEBUG_LOG. Esta es una de mis constantes favoritas y escribe toda la salida en el registro de manera detallada. Voy a cubrir esto en una próxima publicación pero, por ahora, sepa que esto es algo que creo que siempre debe establecerse en su entorno de desarrollo.
WP_DEBUG_DISPLAY. Este es uno que puede establecer en verdadero o falso (aunque prefiero verdadero). Complementa la configuración anterior al permitirle ver los mensajes en el navegador que también se escriben en el blog. No sé si esto es algo que encontrará beneficioso o no. Si no está preparado para revisar los seguimientos de la pila e información más detallada, es posible que desee considerar configurar este como verdadero.
mostrar_errores. El Codex menciona que puede configurar esto como falso, pero creo que debería configurarse como verdadero como una forma de habilitar los errores y las advertencias.
SCRIPT_DEBUG. El núcleo de WordPress utiliza versiones minimizadas de archivos CSS y JavaScript. Desactivar esta configuración le permitirá ver todo el contenido de los archivos en su forma original. Esto es particularmente útil si va a contribuir con Core o trabajar con JavaScript incluido en Core.
GUARDARCONSULTAS. Esta es una configuración un poco más avanzada, en mi opinión. En resumen, tomará todas las consultas que se ejecutan en la base de datos y las guardará en una matriz de PHP que luego podrá analizar. Eso

Ahora que hemos cubierto la configuración de WordPress, ¿qué pasa con los complementos?

Complementos para la depuración

Cuando digo que el repositorio está lleno de complementos para esto, lo digo en serio. De hecho, si eres nuevo en el desarrollo de WordPress, no te recomiendo que vayas a buscar cosas para instalar.

Puede volverse abrumador rápidamente, corre el riesgo de no entender lo que hacen algunos de ellos y, potencialmente, llevarlo por un camino en el que terminará estropeando su instalación.

En lugar de hacer eso, recomiendo echar un vistazo a los siguientes complementos (leer primero su descripción, por supuesto) y luego continuar desde allí:

Barra de depuración. Este complemento solo agrega un menú a la barra de administración que le permitirá ver la consulta, el caché y otra información. Requiere que WP_DEBUG y SAVEQUERIES como se describe anteriormente estén habilitados.
Depuración de dependencias de estilos y secuencias de comandos de la lista de barras. Este es un complemento del complemento anterior que le permitirá depurar más estilos JavaScript y CSS que se ejecutan en el contexto de WordPress.
Consola de barra de depuración. Este complemento es uno que debe usar con vacilación. Como mínimo, le permite ejecutar PHP y MySQL desde el propio WordPress. No recomiendo este complemento a menos que se sienta muy cómodo con cualquiera de los dos idiomas. Aún así, si es así, esto es algo que puede ser poderoso para crear prototipos de una función o una consulta antes de construirla en su complemento.

Examen de registros de errores

En la próxima publicación, comenzaremos a analizar lo que es necesario para examinar el registro de errores que genera WordPress y cómo comprender la información que vemos.

Además, vamos a ver qué es necesario para usar los complementos que se describen en esta publicación. Después de eso, pasaremos a herramientas aún más avanzadas.

Pero un paso a la vez, ¿no?

Sin embargo, por ahora, configure su instalación como se describe anteriormente, instale los complementos vinculados y luego haga lo que pueda para explorar cómo funcionan, qué puede ver en la pantalla y cómo esto puede afectar y beneficiar positivamente su desarrollo.

Sí, puede haber un poco de una curva de aprendizaje. Pero es por eso que nos estamos tomando esto con calma. Hay mucho que aprender y tenemos mucho tiempo para cubrir todo el terreno necesario.

Fuente de grabación: tommcfarlin.com