05 December 2022 -

Cómo instalar y usar Xdebug para depurar en Visual Studio Code

Debugear en Visual Studio puede ser una liada. Aquí intento ahorrarte el tiempo que perdí encontrando cómo hacerlo.

Tabla de contenidos

  1. Introducción

  2. Instala la extensión Xdebug para Visual Studio Code

  3. Instala Xdebug en tu servidor PHP

  4. Configura Xdebug en tu archivo php.ini

  5. Reinicia tu servidor PHP

  6. Crea una nueva configuración de lanzamiento para Xdebug

  7. Establece un punto de interrupción en tu código PHP

  8. Inicia el depurador

  9. Activa el punto de interrupción

  10. Utiliza los controles del depurador

1. Introducción

Xdebug es una poderosa extensión de PHP que proporciona capacidades de depuración y perfilado para aplicaciones PHP. En este tutorial, aprenderemos cómo instalar y usar Xdebug para depurar código PHP en Visual Studio Code.

2. Instala la extensión Xdebug para Visual Studio Code

Para usar Xdebug para depurar en Visual Studio Code, primero deberas instalar la extensión Xdebug. Para hacerlo, abre Visual Studio Code y ve a la pestaña Extensiones (Ctrl+Shift+X). En el cuadro de búsqueda, escribe “Xdebug” e instala la extensión “PHP Debug” de Felix Becker.

3. Instala Xdebug en tu servidor PHP

A continuación, deberas instalar Xdebug en su servidor PHP. Este proceso variará según su entorno de servidor, pero en la mayoría de los casos, puedes utilizar el siguiente comando para instalar Xdebug:

pecl install xdebug

4. Configura Xdebug en tu archivo php.ini

Después de instalar Xdebug en su servidor, deberas configurarlo editando su archivo php.ini. Este archivo suele estar ubicado en el directorio php en su servidor. Agregua las siguientes líneas a su archivo php.ini para habilitar Xdebug:

zend_extension=xdebug.so
xdebug.remote_enable=1
xdebug.remote_host=localhost
xdebug.remote_port=9000

5. Reinicia tu servidor PHP

Después de configurar Xdebug, deberas reiniciar su servidor PHP para aplicar los cambios. Esto habilitará Xdebug y lo hará disponible para su uso.

6. Crea una nueva configuración de lanzamiento para Xdebug

Ahora que Xdebug está instalado y configurado, puedes comenzar a usarlo para depurar su código PHP. Para hacerlo, abre el proyecto que desea depurar en Visual Studio Code y crea una nueva configuración de lanzamiento para Xdebug. Para hacerlo, abre la pestaña Depurar (Ctrl+Shift+D) y haz clic en el icono de engranaje para crear una nueva configuración de lanzamiento. Selecciona “PHP” de la lista de opciones y, a continuación, agregua las siguientes lineas a su configuración de lanzamiento

"serverSourceRoot": 
    "/ruta/hacia/tu/directorio",
"localSourceRoot": 
    "${workspaceRoot}",

7. Establece un punto de interrupción en tu código PHP

A continuación, establece un punto de interrupción en su código PHP haciendo clic en el lado izquierdo del número de línea donde desea detener la ejecución. Esto le indicará al depurador que detenga la ejecución en ese punto, lo que te permitirá inspeccionar el estado de su código y variables.

8. Inicia el depurador

Para iniciar el depurador, haz clic en el botón “Iniciar depuración” en la pestaña Depurar. Esto iniciará su servidor PHP y conectará Xdebug a Visual Studio Code.

9. Activa el punto de interrupción

Ahora que el depurador está en ejecución, abre tu proyecto PHP en un navegador web y vaya a la página donde desea comenzar a depurar. Esto activará el punto de interrupción que estableció en el paso 6 y el depurador detendrá la ejecución en ese punto.

10. Utiliza los controles del depurador

En este punto, puedes utilizar los controles del depurador en Visual Studio Code para avanzar paso a paso en su código y examinar el estado de sus variables. También puedes usar la consola del depurador para evaluar expresiones y ejecutar comandos en tiempo de ejecución.