Saltar la navegación

4.1.- Instalación de herramientas de depuración.

Imagen de una lupa y un escarabajo o bicho.
Devcore (Dominio público)

Concretamente, vas a aprender a preparar un sistema Ubuntu para depurar aplicaciones en lenguaje PHP utilizando Xdebug y el IDE Visual Studio Code.

Aunque existen diversas formas para realizar la instalación de Xdebug. Probablemente la más sencilla es a través del repositorio de extensiones PECL, del que ya hablamos en la unidad 2. Necesitas por tanto asegurarte de que PECL está disponible en tu instalación de PHP. Para instalarlo desde los repositorios de Ubuntu, ejecuta desde una consola:

sudo apt-get install php-pear
Es conveniente mantener actualizados los repositorios ejecutando sudo apt-get update antes de instalar paquetes.

Además, para poder compilar las extensiones que descargues con PECL, debes instalar el paquete con las herramientas de desarrollo php-dev. Incluye dos programas necesarios para instalar Xdebug: phpize y php-config.

sudo apt-get install php-dev

Si todo fue bien, ya tienes el sistema preparado para instalar Xdebug.

sudo pecl install xdebug

Al finalizar la instalación verás un mensaje como el siguiente:

Imagen donde se puede ver la terminal de ubuntu, arriba en un recuadro delimitado por quiones una serie de instrcciones de instalación abajo y casi alfinal un mensaje en ingles advirtiéndonos que tenemos que activar la libreria xdebug.so en el archivo php.ini
Captura de pantalla (Elaboración propia)

En esa pantalla figura (tras "Installing") la ruta en que se ha instalado la extensión (fichero xdebug.so). Además te indica que debes modificar el fichero "php.ini" para activarla. Abre por tanto el fichero "php.ini" (en la fecha de elaboración de este manual  la ruta es "/etc/php/7.4/apache2/php.ini") de tu instalación de PHP, y añade las siguientes líneas al final.

[xdebug]
zend_extension="/usr/lib/php/20190902/xdebug.so"
; Opciones de configuración
xdebug.remote_enable = 1
xdebug.remote_autostart = 1

Ajusta la ruta anterior al fichero "xdebug.so" para que sea la misma que has obtenido en tu sistema tras instalar la extensión.

Por último, recuerda reiniciar el servidor web siempre que modifiques el fichero "php.ini" para aplicar los cambios.

Al final podemos comprobar con el archivo "info.php" en la parte correspondiente a xdebug que todo está funcionando.

Imagen del archivo info.php en la parte de Xdebug, donde se pueden ver en una tabla una serie de configuraciones y parámetros.
Captura de pantalla de Firefox. (Elaboración propia.)

Con Xdebug instalado y funcionando, preparemos Visual Studio Code, este nos ofrece varias extensiones para trabajar con Xdebug, el funcionamiento de ellas es muy parecido. Instalaremos la extensión: PHP Debug de "Felix Becker"

Imagen de Visual Studio Code, a la derecha aparece la extensión PHP Debug y sus instrucciones de instalación y configuración.
Captura de Pantalla deVisual Studio Code (Elaboracion propia)

 

Para saber más

Si necesitas instalar Xdebug en sistemas Windows, puedes encontrar información al respecto en Internet. En la página web de la extensión Xdebug tienes un asistente que analiza tu archivo phpinfo() y te recomienda lo que tienes que hacer para la instalación (información en lenguaje inglés).

Página web de la extensión asistente Xdebug.