Name: Xdebug: Understanding, Using, and Sorting Out Problems
Start: 2024-05-22T08:00:00-06:00
End: 2024-05-22T09:00:00-06:00

This is the latest edition of [DDEV Live Contributor Training](https://ddev.com/blog/contributor-training).

We'll look into the intricacies of [Xdebug](https://xdebug.org/) in general and with [DDEV's support ](https://ddev.readthedocs.io/en/stable/users/debugging-profiling/step-debugging/)specifically.

General outline:

* How Xdebug works (network protocol, php makes the connection, IDE is listener)
* [Troubleshooting xdebug](https://ddev.readthedocs.io/en/stable/users/debugging-profiling/step-debugging/#troubleshooting-xdebug) tries to explain this
* The normal technique with DDEV is to start the IDE listening and `ddev xdebug on`
* vscode extension does all this for you
* You can set up xdebug several other ways, see [xdebug.org](http://xdebug.org). But DDEV’s base technique has been accessible and usable and reliable for many, many people.
* Because it’s a network protocol, anything that gets in the way of TCP can break it. This includes name resolution, firewalls, and DDEV’s own mapping of `host.docker.internal` to a proper IP address.
* If you’re having trouble, go through the [troubleshooting instructions](https://ddev.readthedocs.io/en/stable/users/debugging-profiling/step-debugging/#troubleshooting-xdebug) carefully, step-by-step
* DDEV tries to sort out network difficulties, but there are specific situations that can require manual intervention
* On WSL2, it’s possible to run your IDE inside linux (using the Linux version of vscode or PhpStorm). In that case, you need to `ddev config global --xdebug-ide-location=wsl2`
* On WSL2 and with the IDE on Windows there are times that DDEV just can’t figure out what the right IP address using all the available tools. In this case, if you can figure it out, you can use `ddev config global --xdebug-ide-location=`
* If you’re running your IDE on something that is network-reachable from inside the web container and it is not the normal host location, you can set an explicit `xdebug-ide-location` to reach it.
* Send money to Derek
* First thing in any language is learning to debug

Randy Fay

DDEV Live Events

Technology

Web Design

Open Source

New Technology

Web Development

Mobile Development

Computer Programming

Mobile Technology

Software Development

Web Technology

Ralf Koller

Sibin Grašić

Xdebug: Understanding, Using, and Sorting Out Problems 

Online event

Share

DDEV Live Events

Xdebug: Understanding, Using, and Sorting Out Problems

DDEV Live Events

Details

Members are also interested in