Instalación de Xdebug, Parte 1: El módulo Xdebug

Por ahora, hemos cubierto mucho terreno relacionado con el trabajo con WordPress y la depuración. Y esto es especialmente cierto en lo que respecta al trabajo con herramientas y complementos disponibles en WordPress. Si acaba de unirse a esta serie en particular, asegúrese de estar al día con las siguientes publicaciones:

• Lectura y comprensión de los registros de errores de WordPress, Parte 1
• Lectura y comprensión de los registros de errores de WordPress, parte 2
• Depuración básica dentro de WordPress

En el post anterior, recuerda que dije lo siguiente:

Pero si está buscando ingresar al mundo de la depuración práctica y profesional desde su IDE, entonces es importante comprender qué, cómo y por qué.

Y finalmente estamos listos para ver lo que esto requiere. Sin embargo, para comenzar, significa que debemos comprender algunas cosas sobre Xdebug, la terminología y tener un IDE que sea consistente para todos los que lean esta serie en particular.

Así que esto se dividirá en dos partes.

• Primero, veremos la terminología requerida para la depuración y nos aseguraremos de tener una configuración IDE adecuada en nuestro entorno de desarrollo.
• A continuación, veremos cómo asegurarnos de haber instalado correctamente Xdebug y luego conectarlo a nuestro entorno de desarrollo para que podamos ponerlo a trabajar.

Si ha leído una variedad de contenido a lo largo de este blog en los últimos años, algo de esto puede parecerle familiar. Si no, no es gran cosa. Recuerde que el objetivo es asegurarse de que todos estemos al mismo nivel a medida que avanzamos con el trabajo mencionado anteriormente y durante el resto de la serie.

Dicho esto, comencemos.

Instalación de Xdebug, Parte 1

Como se mencionó anteriormente, este conjunto de publicaciones servirá para uno de los dos propósitos, los cuales se pueden describir sucintamente (el segundo de los cuales se describirá en la próxima publicación):

1. Terminología de depuración
2. Instalación de un IDE

Aunque muchos de los que lean esto ya estarán familiarizados con parte de la terminología (especialmente si ha usado herramientas del lado del cliente o incluso herramientas del lado del servidor antes), y ya tiene un editor de elección, es importante asegurarse de que estamos al menos trabajando con una base consistente.

Si confía en sus habilidades en los dos puntos mencionados anteriormente, es probable que la próxima publicación sea más interesante para usted. Si, por otro lado, esto te está introduciendo en un nuevo territorio, debería sentar las bases para todo lo que necesitas para asegurarte de que estás depurando con éxito los proyectos en WordPress.

Además, se asegurará de que tenga un conjunto coherente de herramientas con las que trabajar para que podamos seguir avanzando con un conjunto estándar de herramientas para crear el entorno de desarrollo más productivo posible.

1 Terminología de depuración

Dependiendo de sus antecedentes, podría argumentar que hay entre cinco y siete términos, cada uno de los cuales está relacionado con la depuración. Lo he esbozado antes en otras publicaciones en este sitio. Cada vez, sin embargo, lo he hecho con una versión un poco diferente del contenido.

En esta publicación, mi objetivo es tratar de hacer esto lo más exacto y preciso posible para que proporcione una referencia consistente que podamos usar en las publicaciones (y en el trabajo) por venir. Tal como está ahora, estos son los términos que creo que todos deberían saber en relación con su depurador.

1. Puntos de ruptura. Estos pueden considerarse los bloques fundamentales de la depuración. En pocas palabras, son lugares en el código en los que desea pausar la ejecución para poder examinar lo que sucede en el código. Quizás esto tenga que ver con las variables; quizás tenga que ver con funciones, quizás tenga que ver con otra cosa. Independientemente, esto es importante porque le está diciendo al programa "oye, quiero detener la ejecución del programa aquí mismo en esta línea para poder investigar el estado del programa".
2. relojes _ Estas son llamadas a funciones, variables u otros lugares en el código que pueden configurarse de manera que podamos ver literalmente cómo cambian los valores a lo largo de la ejecución. Si estamos hablando de funciones, entonces podríamos estar refiriéndonos a los valores de los argumentos a medida que se establecen y manipulan dentro de una función. Si estamos hablando de variables, estamos hablando de variables; entonces estamos hablando de los valores que tienen en cualquier punto dado durante la ejecución del programa. Esto puede ser cuando establecemos un punto de interrupción específico, o puede ser cada vez que repasamos el código y vigilamos el estado de la variable a lo largo de la ejecución del programa.
3. Empezar _ Esta acción simplemente le dice al depurador que comience a monitorear el servidor web. Esencialmente, está vigilando todo lo que sucede dentro del programa y, si se establecen puntos de interrupción, está preparado para detener la ejecución y permitirnos ver qué sucede con el estado del programa. Técnicamente, puede iniciar una sesión de depuración y no hacer nada en absoluto. No es exactamente productivo, pero es posible.
4. Entra en. Suponga por un momento que tiene un punto de interrupción establecido justo encima de una llamada de función o en una invocación de función. Esto nos permite ingresar a la función para monitorear el valor de cada argumento, cómo se manipulan dentro de la función, qué devuelve la función (si es que hay algo) y todo lo que sucede dentro de la función.
5. Pasar por encima. Por otro lado, suponga que está recorriendo la función y no está seguro de querer sumergirse en ella. Tal vez solo le interesen los valores que devuelve la función o el estado del programa después de que se haya ejecutado la función, pero no le interesa lo que sucedió dentro de la función. En esencia, lo tratas como una caja negra. Eso es lo que significa pasar por encima de una función. Es decir, deja que la función se ejecute sin entrar en ella para ver cómo funciona.
6. Paso fuera. Este aspecto particular de la depuración es útil cuando se encuentra en una función y está listo para volver a la línea principal de ejecución porque ha visto todo lo que necesita ver. Tal vez hayas visto cambiar los valores de una variable, tal vez hayas visto un algoritmo hacer suficiente trabajo para saber que ha hecho lo que quieres. Cualquiera que sea el caso, esto le permitirá salir de la función, acertadamente nombrada, y luego pasar a la
7. Detener _ Así como start le dice al depurador que comience a escuchar al servidor, prestando atención a los puntos de interrupción y mostrando información sobre el progreso de la aplicación, stop hace exactamente lo contrario. Le dice al depurador que hemos terminado de escuchar, mirar y prestar atención al estado del programa. Esto no significa que el programa se detenga, solo el depurador. Entonces, si ha terminado de prestar atención a toda la información proporcionada por el depurador, es probable que esté en condiciones de detener el depurador.

Una nota final que me gustaría hacer es que PHP es único en el sentido de que ofrece una variedad de variables de acceso público, como $_GET , $_POST, $_REQUEST, etc. Estas también son variables que están disponibles para nosotros y que podemos observar. No se limita solo a lo que tenemos escrito en nuestro código.

Esto es especialmente útil ya que estamos buscando datos en recargas de página, solicitudes Ajax (como durante las acciones GET y POST), etc.

2 Instalación de Xdebug

Aunque es probable que sea evidente por las publicaciones anteriores de esta serie, usaré Visual Studio Code como mi IDE de elección. Si no tienes uno, entonces este es uno que te recomiendo. Sin embargo, si tiene un IDE con el que se siente cómodo, entonces este es uno que le recomiendo.

• El código siempre está en desarrollo,
• tiene una economía activa de extensiones,
• funciona bien con una variedad de lenguajes, herramientas, etc.
• es liviano y funciona bien con las diversas cosas que podemos usar en el desarrollo de WordPress (como PHP, HTML y JavaScript).

Además, Code también tiene un sólido soporte para Xdebug. Sin embargo, para asegurarnos de que el depurador esté correctamente instalado, debemos asegurarnos de que tenemos la extensión instalada con nuestra instalación de PHP, que está disponible en todo nuestro sistema y que se puede ejecutar dentro de nuestro IDE. Vamos a considerar hacer esto, pero primero, debemos asegurarnos de que Xdebug esté instalado correctamente.

Instalando Xdebug

Instalar Xdebug es fácil. Desde su sesión de terminal, deberá ejecutar el siguiente comando:

Una vez que lo haga, notará que suceden varias cosas dentro de la ventana del terminal a medida que se lleva a cabo la instalación. A menos que esté particularmente interesado, no necesita preocuparse por lo que está haciendo hasta que lo devuelva al símbolo del sistema.

En este punto, se ha instalado el módulo Xdebug; sin embargo, necesitará decirle a PHP que está instalado y dónde puede encontrar el módulo.

Para instalar la extensión con su versión actual de PHP, es importante saber qué versión de PHP tiene instalada. Si está utilizando un administrador de paquetes, entonces puede haber varias versiones y necesitará decirle al archivo de configuración de esa versión en particular dónde encontrar el módulo.

Por el contrario, si tiene una sola versión instalada, entonces necesitará decirle a una sola versión de PHP dónde está instalada. Primero, puede encontrar dónde existe Xdebug en el sistema de archivos usando este comando:

Luego necesitará actualizar el archivo de configuración para su instalación de PHP. Para hacer esto, simplemente ejecute php -v desde la línea de comandos y le dirá qué versión está ejecutando. Desde aquí, deberá ubicar el archivo de inicialización para la versión de PHP que está utilizando. Si, al ejecutar php -v, regresa con algo como esto:

Esto nos dice que estamos ejecutando PHP 7.1.19 (aunque su versión puede variar). A partir de aquí, sabemos buscar un determinado archivo de configuración de PHP para esta versión de PHP. Para hacer esto, busque php.ini en el directorio /usr/local/etc/php/7.1/ de su sistema (aunque el número de versión exacto puede variar).

Desde allí, abra el archivo y luego agregue la siguiente línea de código:

zend_extension="/usr/local/lib/php/pecl/20160303/xdebug.so"

Esto le dirá a PHP dónde reside Xdebug para que pueda usarse dentro de su trabajo.

Prueba de la instalación

Para comprobar que la instalación ha ido correctamente, puedes ejecutar el siguiente código en tu terminal:

Y luego debería ver algo como el siguiente resultado en la pantalla:

Observe que en la captura de pantalla anterior, ve lo siguiente:

con Xdebug v2.6.0, Copyright (c) 2002-2018, por Derick Rethans

Esto significa que el módulo ha sido instalado y que PHP lo sabe.

Configurando su IDE

En la próxima publicación, veremos cómo vincular Xdebug a nuestro IDE. Suponiendo que haya seguido los pasos de esta publicación y que todo haya ido bien, debería estar listo para prepararse para depurar proyectos de WordPress.

Sin embargo, hasta que no lo tengamos funcionando dentro de un IDE, no es tan útil (o es más difícil de lo que debería ser). Entonces, la próxima semana, veremos exactamente cómo hacerlo.