Be part of JetBrains PHPverse 2026 on June 9 – a free online event bringing PHP devs worldwide together.

sic's avatar
Level 1

XDebug 3 with Homestead & PhpStorm

Hey there,

I'm trying to use XDebug 3 with Homestead (PHP 8) but can't make it work.

Do you know any tutorial / stack overflow topic / whatever?

I have updated the xdbeug config file but yeah that didn't help.

zend_extension=xdebug.so
xdebug.client_port = 9003
xdebug.max_nesting_level = 512
xdebug.mode=debug
xdebug.start_upon_error = true
xdebug.start_with_request = yes

XDebug is loaded, I have checked that via phpino() and also PhpStorm has detected it.

0 likes
4 replies
PetrKaterinak's avatar
Level 3

I also had the issue, this works for me:

[xdebug]
zend_extension="xdebug.so"
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=localhost
xdebug.remote_handler=dbgp
xdebug.client_port=9000

Also change port to 9000 was required, although PHPStorm had 9000, 9003 setted up

1 like
sic's avatar
Level 1

Hey thanks! Copied your settings but it still doesn't work.

I wonder if I forgot something... Did you add a "Run/Debug Configuration" for XDebug in PhpStorm? I think this is no longer necessary?

automica's avatar

@sic you will need to restart php on your homestead for settings to take effect.

sudo service php8.0-fpm restart

Please or to participate in this conversation.