02. Setting Up Xdebug on VSCode

Xdebug is already installed and configured with develop, debug and coverage modes enabled by default. To enable VSCode integration follow the steps bellow:

1. Install PHP Debug plugin: https://marketplace.visualstudio.com/items?itemName=xdebug.php-debug

2. Click on "Run and Debug" tab on VSCode and add new configuration in launch.json file:

{
    "name": "Listen for Xdebug",
    "type": "php",
    "request": "launch",
    "port": 9003,
    "pathMappings": {
        "/var/www/laravel-app": "${workspaceRoot}"
    }
}

3. Debug session will start by trigger.
   Add ?XDEBUG_TRIGGER in the query string of your request and start listening on VSCode by clickin on "Start Debbuging", or press F5.

4. Additionaly, You can install Xdebug helper for Chrome instead of adding the trigger manually every time.

Relevant commits

• https://github.com/danieltrolezi/laravel-app/commit/28cd5cd35f083e8e596b0763351a1c823625d6ce
• https://github.com/danieltrolezi/laravel-app/commit/242f33d79d3bbbcde3c645dbde77d3fec15bca56
• https://github.com/danieltrolezi/laravel-app/commit/802ced737c1ee45f316c3fd648ac8bda86c24dbc

References

• XDebug e Docker - Configurar PHPStorm e VSCode para funcionar com XDebug usando Docker | Dias de Dev
• Setup Step Debugging in PHP with Xdebug 3 and Docker Compose
• Xdebug: entenda como funciona e como resolver problemas na sua configuração
• Xdebug Documentation - All Settings