Xdebug3 + WSL2

I would suggest adding the "xdebug.log" directive and check the log file afterwards. By the way, do you debug a web application, right?

Yes, I'm trying to debug web application. Setting xdebug.log I get the following messages:

[3010] Log opened at 2021-04-01 18:31:41.957959
[3010] [Step Debug] INFO: Connecting to configured address/port: localhost:9003.
[3010] [Step Debug] WARN: Creating socket for 'localhost:9003', poll success, but error: Operation now in progress (29).
[3010] [Step Debug] ERR: Could not connect to debugging client. Tried: localhost:9003 (through xdebug.client_host/xdebug.client_port) :-(
[3010] [Step Debug] INFO: Connecting to configured address/port: localhost:9003.
[3010] [Step Debug] WARN: Creating socket for 'localhost:9003', poll success, but error: Operation now in progress (29).
[3010] [Step Debug] ERR: Could not connect to debugging client. Tried: localhost:9003 (through xdebug.client_host/xdebug.client_port) :-(
[3010] [Step Debug] INFO: Connecting to configured address/port: localhost:9003.
[3010] [Step Debug] WARN: Creating socket for 'localhost:9003', poll success, but error: Operation now in progress (29).
[3010] [Step Debug] ERR: Could not connect to debugging client. Tried: localhost:9003 (through xdebug.client_host/xdebug.client_port) :-(
[3010] Log closed at 2021-04-01 18:31:41.985802

Basically, XDebug should connect to the <ide_machine>:9003 which is generally not the "localhost" in the case of WSL2. 

So, you may want to hardcode your host machine IP/name with the "xdebug.client_host=" directive. Otherwise, you may enable the "xdebug.discover_client_host" option for XDebug to detect the HTTP client address automatically.

A little bit more about these options:
https://xdebug.org/docs/all_settings#discover_client_host
https://xdebug.org/docs/all_settings#client_host

Thanks guys for your help!

Adding xdebug.client_host with IP of my PC (not wsl instance) has resolved my issue!

Cool!

Thanks for the update and have a productive new week.

Vasiliy Yur

Add the below config. Restarted PHP FPM. Despite that, the following error is shown in PHPStorm:

Connection was not established. Cannot start debugger session with 'Xdebug 3.0.4

XDebug Config:

xdebug.remote_host=192.168.29.249
xdebug.client_host=192.168.29.249
xdebug.client_port=9000
xdebug.log="/var/log/xdebug.log"

Nothing is printed in the logs.

This is a portion of the command executed by PHPStorm:

php -dxdebug.remote_enable=1 -dxdebug.remote_mode=req -dxdebug.remote_port=9000 -dxdebug.remote_host=127.0.0.1

Unsure as to why the host is passed as 127.0.0.1

Passed additional params via config option. The connection cannot be established yet

php -dxdebug.remote_enable=1 -dxdebug.remote_mode=req -dxdebug.remote_port=9000 -dxdebug.remote_host=127.0.0.1 "-d xdebug.remote_host=192.168.29.249"

Can you share the steps to get this working?

Thanks!

Vasiliy Yur

Created a new post here: https://intellij-support.jetbrains.com/hc/en-us/community/posts/4406842719378-Setting-up-debugging-with-XDebug-3-and-WSL2

replied in a new post

Thanks, Dmitry Tronin for the detailed response. Got engaged in other activities. The steps you mentioned worked - irrespective of the internet/VPN connection.

Wanted clarity on a couple of items:

1. On every restart the IP of WSL2 changes. Wrote a temporary bash script to update the IP in XDebug. Any other approaches to handle this?

2. For the first debug attempt after a restart the following error is thrown. Any ideas on resolving this?

PS: Having this in the documentation website would certainly help many others.

Replied there.