Instalación y configuración Xdebug de PHP sobre VScode

Instalación de xdebug

En ubuntu/debian con el repositorio de php de ondrej instalamos con apt la versión de xdebug de la versión de php con la que estamos trabajando, por ejemplo para php7.3, la instrucción sería:

apt install php7.3-xdebug

Configuración de xdebug

A continuación debemos editar el archivo /etc/php/7.3/mods-available/xdebug.ini, de manera que contenga algo como esto:

zend_extension=xdebug.so

xdebug.mode = debug
xdebug.client_host = <ip donde se ejecuta VScode>
xdebug.client_port = 9003
xdebug.start_with_request=yes
xdebug.idekey = VSCODE
xdebug.discover_client_host=false

xdebug.remote_enable=1
xdebug.remote_autostart=1

Configuración de VSCODE

Por último para poner en marcha VScode a depurar, seguimos los siguientes pasos:

• Instalamos el plugin "PHP Debug"
• En Run > Open configurations nos abrirá el archivo de configuración de ejecuciones (launch.json)
• En dicho json incorporamos nuestra propia configuración, algo similar a lo siguiente:

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Listen for Xdebug",
            "type": "php",
            "request": "launch",
            "port": 9003,
            "pathMappings": {
                "/root/core_fct_api": "${workspaceFolder}",
            }
        }
    ]
}

• Editar el mapping del archivo, por ejemplo (/root/core_fct_api debería apuntar a tu carpeta de proyecto)
• Una vez hecho esto ya se puede arrancar el debug con F5 y finalizar con Shift+F5

Otras teclas útiles durante el debug:

• F5 => saltar breakpoint y seguir ejecución
• F10 => step over (salto de linea sin penetrar en funciones)
• F11 => step into (salto de linea penetrando sobre funciones)
• F11 + shift => step out (sale de la función actual y sube de ámbito)

Última actualización: 29 de Septiembre de 2023 a las 12:28 (CET)