php - Want Xdebug -- Using Win10 WSL Ubuntu 20, vscode and Laravel

Solution:

You have two options to enable debugging:

• Use the VSCode Remote - WSL extension and let VSCode configure everything else for you
• Configure XDebug Remote Configuration in php.ini

My recommendation is using the WSL Extension method.

Keep in mind if you decided to use the Extension method, there will be a problem regarding Git not recognizing modified files correctly

Solution:

You have XDebug 3 installed. Version 3 of Xdebug changed the way you need to configure is's settings. The most important breaking change is that the listening port now is 9003 instead of 9000. This is the php.ini configuration in my localhost for Xdebug 3 (it should work anywhere):

[xdebug]
zend_extension="C:\xampp\php\ext\php_xdebug-3.0.4-7.4-vc15-x86_64.dll"
xdebug.mode=develop,debug
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
xdebug.start_with_request=trigger
Copy code

Change the path to your Xdebug extension and you should be able to debug your code now.

Solution:

You don't need to install XAMPP, all settings are managed by your WSL with installed PHP. I have a Laravel project with docker using WSL2 (Ubuntu 20) in Windows 10 21H2 and here is my settings to make xdebug work. I use Xdebug 2.9.8, there're some changes of text in xdebug.ini, but most of them are same.

PHP 7.1.33 (cli) (built: Nov 22 2019 18:34:33) ( NTS )
Copyright (c) 1997-2018 The PHP Group
Zend Engine v3.1.0, Copyright (c) 1998-2018 Zend Technologies
    with Xdebug v2.9.8, Copyright (c) 2002-2020, by Derick Rethans
Copy code

1. If you use mount your project/files from Windows to your WSL2 environment

xdebug.ini

xdebug.remote_enable = On
xdebug.remote_autostart = On
xdebug.remote_connect_back = Off
xdebug.remote_host = "host.docker.internal"
xdebug.remote_port=9009 
Copy code

Dockerfile

FROM php:7.1-fpm
RUN pecl install xdebug-2.9.8 \
&& docker-php-ext-enable xdebug
COPY xdebug.ini /usr/local/etc/php/conf.d/
Copy code

Docker-compose.yml

services:
 webapp:
  working_dir: /var/www/html
  volumes:
  - ./my-project-folder:/var/www/html
Copy code

Move in to your project folder, typecode . to open projet with WSL and then create debug file (launch.json): (enable your PHP Xdebug extension inside WSL by click on extenstion and choose 'enable')

"name": "Listen for Xdebug",
        "type": "php",
        "request": "launch",
        "port": 9009,
        "pathMappings": {
            "/var/www/html": "${workspaceFolder}"
        }
Copy code

2. If you use wsl file system (clone your project inside your wsl enviroment instead of mounting it from Windows) The setting is almost similar to (1) but you need a little additional setting:

Docker-compose.yml

extra_hosts:
  - "host.docker.internal:host-gateway"
Copy code

VS Code's launch.json

"hostname": "0.0.0.0",
Copy code

That's all. 2nd method is much faster than 1st method in my experience.