Cómo instalar Xdebug en XAMPP para depurar PHP en Visual Studio Code

Introducción:

Xdebug es una poderosa herramienta de depuración para el desarrollo en PHP que facilita la identificación y corrección de errores en el código. Si eres un desarrollador de PHP y trabajas con XAMPP como servidor local, instalar Xdebug y configurarlo correctamente te permitirá realizar tareas de depuración de manera más eficiente. En este artículo, te guiaremos paso a paso para instalar Xdebug en XAMPP y configurarlo con Visual Studio Code para depurar tu proyecto PHP.

Requisitos previos:

- Tener instalado XAMPP en tu sistema.
- Tener Visual Studio Code instalado en tu sistema.
- Acceso a internet para descargar los archivos necesarios.

Pasos para instalar Xdebug en XAMPP:

Paso 1: Crear un archivo phpinfo.php
Para obtener la información necesaria para configurar Xdebug, crearemos un archivo llamado `phpinfo.php` en el directorio de tu proyecto PHP. Agrega el siguiente contenido al archivo:

phpinfo();
?>
 

Paso 2: Ejecutar phpinfo.php en el navegador
Inicia tu servidor local de XAMPP y accede al archivo `phpinfo.php` desde tu navegador (por ejemplo, http://localhost/tu_proyecto/phpinfo.php). La página mostrará toda la información sobre la configuración de PHP en tu servidor.

Paso 3: Descargar la DLL de Xdebug
En la página de phpinfo, busca la sección "Xdebug" y anota la versión de PHP que estás utilizando (por ejemplo, PHP 7.4). Luego, dirígete al sitio web oficial de Xdebug (https://xdebug.org/download#releases) y descarga la DLL correspondiente a tu versión de PHP y arquitectura (x86 o x64).

Paso 4: Copiar la DLL de Xdebug a la carpeta "ext" de PHP
Una vez descargada la DLL de Xdebug, copia el archivo `php_xdebug.dll` a la carpeta "ext" de tu instalación de PHP en XAMPP (por ejemplo, C:\xampp\php\ext).

Paso 5: Modificar el archivo php.ini
Abre el archivo `php.ini` que se encuentra en la carpeta "php" de XAMPP (por ejemplo, C:\xampp\php\php.ini) y agrega las siguientes líneas al final del archivo:

[Xdebug]
zend_extension = "C:\xampp\php\ext\php_xdebug.dll"
xdebug.mode = debug
xdebug.start_with_request = yes
 

Paso 6: Reiniciar el servidor Apache
Para que los cambios en el archivo php.ini surtan efecto, reinicia el servidor Apache desde el Panel de Control de XAMPP.

Pasos para configurar Visual Studio Code para depurar PHP:

Paso 1: Instalar la extensión "PHP Debug"
Abre Visual Studio Code, ve a la sección de extensiones y busca e instala la extensión "PHP Debug" creada por Felix Becker.

Paso 2: Configurar el archivo launch.json
Haz clic en el icono de engranaje en la barra lateral izquierda de Visual Studio Code y selecciona "Add Configuration...". Selecciona "PHP" como el tipo de configuración. Esto creará un archivo `launch.json` en la carpeta ".vscode" de tu proyecto.

Paso 3: Configurar el archivo launch.json para Xdebug
Abre el archivo `launch.json` y asegúrate de que tenga la siguiente configuración:

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Listen for XDebug",
      "type": "php",
      "request": "launch",
      "port": 9003,

      "pathMappings": {

                "c:/xampp/htdocs/tu_proyecto": "${workspaceFolder}"

            }

    }
  ]
}

Paso 4: Iniciar la sesión de depuración
Ahora, inicia tu servidor Apache con Xdebug activado y ve a tu proyecto PHP desde el navegador. Luego, vuelve a Visual Studio Code y haz clic en el botón "Start Debugging" o presiona F5 para iniciar la sesión de depuración.

Conclusión:

¡Enhorabuena! Ahora tienes Xdebug correctamente instalado en tu entorno local con XAMPP y configurado para depurar tu proyecto PHP en Visual Studio Code. Con esta configuración, podrás detectar y solucionar errores en tu código PHP de manera más eficiente, lo que te permitirá desarrollar aplicaciones PHP de alta calidad. ¡A disfrutar de una depuración sin complicaciones y un desarrollo más productivo!