Depuración de Código PHP en VS Code

Curso de Visual Studio Code para desarrolladores PHP

5.2 Introducción a la Depuración en PHP

La depuración es el proceso de identificar y corregir errores en el código, y es una parte esencial del desarrollo de software:

1. ¿Por qué es importante la depuración?
   • La depuración te permite comprender exactamente qué sucede en cada línea de tu código, algo especialmente útil cuando el programa no funciona como esperabas o cuando aparecen errores que necesitas corregir.
   • Sin depuración, el proceso de resolver problemas puede ser más largo y menos preciso, ya que dependerías de pruebas manuales o impresiones de variables para entender el flujo del programa.
2. Flujo de Depuración:
   • Durante la depuración, podrás analizar cómo los datos cambian a medida que tu código se ejecuta y encontrar errores lógicos (por ejemplo, variables con valores incorrectos o llamadas a funciones inesperadas).

5.2 Configuración de PHP Debug

Para depurar PHP en Visual Studio Code, necesitas configurar una herramienta de depuración como Xdebug junto con la extensión PHP Debug. Este paso es esencial para que el editor pueda conectarse y realizar la depuración en tiempo real.

1. Instalación de Xdebug:
   • Xdebug es una extensión de PHP que permite la depuración avanzada. Dependiendo de tu sistema, puedes instalarlo usando los siguientes comandos:
     • En Windows: Xdebug generalmente viene incluido en soluciones como XAMPP, pero puedes configurarlo en el archivo php.ini.
     • En macOS: Usa herramientas como Homebrew (brew install php-xdebug) o configura manualmente.
     • En Linux: Instala Xdebug con sudo apt install php-xdebug y verifica la instalación con php -m | grep xdebug.
2. Configurar PHP Debug en VS Code:
   • Primero, instala la extensión PHP Debug desde la tienda de extensiones de VS Code.
   • Luego, abre la configuración de depuración (icono de depuración en la barra lateral) y selecciona «Add Configuration». Elige PHP y VS Code creará un archivo launch.json en tu proyecto con configuraciones para depuración.
   • Asegúrate de ajustar el puerto (comúnmente el 9003) y otros detalles según las instrucciones de Xdebug.

5.3 Configuración de Puntos de Interrupción y Ejecución Paso a Paso

Una vez configurado el entorno de depuración, puedes utilizar puntos de interrupción (breakpoints) y herramientas de ejecución paso a paso para revisar el flujo del código y comprender mejor su comportamiento.

1. Establecer Breakpoints:
   • Los breakpoints son puntos específicos en el código donde deseas detener la ejecución para analizar variables y otros datos en ese momento exacto.
   • Para establecer un breakpoint, haz clic en el margen izquierdo de la línea de código donde quieres detener la ejecución. Un pequeño punto rojo indicará el breakpoint.
2. Ejecución Paso a Paso:
   • Una vez que la depuración está en marcha, puedes utilizar los controles de «Step Over» (paso a paso), «Step Into» (entrar en funciones) y «Step Out» (salir de funciones) para navegar el código línea por línea.
   • Estas herramientas son útiles para observar cómo cambian las variables y detectar el flujo exacto del código.
3. Ver Variables y Consola de Depuración:
   • Durante la ejecución de la depuración, puedes ver el valor de todas las variables en el panel de variables y monitorear su estado a medida que avanzas en el código.
   • También puedes usar la consola de depuración para evaluar expresiones, ejecutar fragmentos de código o consultar el valor de variables específicas.