docs: PhpStorm CLI debug error "Can't find a source position. Server with name 'SITE_NAME.ddev.site' doesn't exist."

[RuZniki]

The Issue

When trying to debug PhpUnit, and command-line PHP processes with PhpStorm I get error:

"Can't find a source position. Server with name 'SITE_NAME.ddev.site' doesn't exist."

I found that PHP | Servers - Name is important, not only Host.
My ddev project name is 'drupal'. And debuging starts to work only after I change server name to 'drupal.ddev.site'

This settings doesn't work for CLI debugging.

After change server name, working settings.

I had an issue with debug from CLI and PHPUnit
On PhpStorm PHP server name setting is important. I had an issue with debug to unders

How This PR Solves The Issue

Update documentation page "Step Debugging with Xdebug".

Related Issue Link(s)

php-perfect/ddev-intellij-plugin#227

[rfay]

Thanks for this contribution. I'd rather see it solved in

• Please use the primary sitename of the DDEV project as the "server" name php-perfect/ddev-intellij-plugin#259

We'll see what @nico-loeber says.

Mostly I try to avoid adding "every little thing" to the docs. Would Stack Overflow be a better place to put this?

Regardless, please change the title of this issue to have the error encountered, so people will find it.

[RuZniki]

Randy, thanks for feedback, I updated issue description and title.

[rfay]

I think this may belong here OK, as long as you remember to remove it when the extension gets fixed :) Suggested minor verbiage change that you can just accept if you like it.

[RuZniki]

Thanks for you suggestion. Accepted. I do my best to remove it as soon it would be fixed.

[rfay]

Thanks!