vagrant - debugging laravel artisan from PHPStorm with homestead

Question

I setup Laravel Homestead. I then configured both homestead xdebug.ini and PHPStorm to make the debugging work.

Here is my xdebug.ini inside homestead

zend_extension=xdebug.so
xdebug.remote_autostart = on
xdebug.remote_enable = on
xdebug.remote_connect_back = on
xdebug.remote_port = 9000
xdebug.idekey = "vagrant"

To start a debugging session the steps I follow are

1. In PHPStorm --> Start Listening for connections
2. In PHPStorm set a breakpoint
3. In my browser --> Use XDebug Chrome Helper OR add to my URL ?XDEBUG_SESSION_START=
4. Load the page

This works perfectly. My problem is when I'm inside homestead command line and I run a php artisan command then I can't get it to hit my breakpoints.

What I've tried

1. XDEBUG_CONFIG="idekey=PHPSTORM" PHP_IDE_CONFIG="serverName=server_name" php -dxdebug.remote_host="127.0.0.1" artisan mycommand

2. php -d xdebug.profiler_enable=On artisan mycommand

3. I also tried to set xdebug.remote_autostart=On then sudo service php5-fpm restart but still my breakpoints never get hit in PHPStorm

Answer 1

Two things are important:

1. remote_connect_back can not work in the CLI case because Xdebug can not detect the remote IP when you are in the console
2. When using homestead / VirtualBox in the NAT network configuration, your development machine (which is running PHPStorm) does not have the IP 127.0.0.1 seen from inside the VM. Instead, it has usually an IP like 10.0.2.2. To find out the correct IP, have a look at your Apache's access.log,

The following worked for me:

php -dxdebug.remote_autostart=on -dxdebug.remote_connect_back=off 
  -dxdebug.remote_host=10.0.2.2 artisan

3. edit If your breakpoints are not hit, you have to set up the folder mappings correctly (as your path in the IDE is different from what the web server sees:

4. Do export PHP_IDE_CONFIG="serverName=yourservername" in your VM, where yourservername is what you configured in the screenshot under "name"

5. Add a Php Remote Debug Configuration with an IDE key and the server configured above

6. And add your IDE key and the remote_host to the VM's XDEBUG-CONFIG

   export XDEBUG_CONFIG="idekey=artisan remote_host=10.0.2.2"

References: http://randyfay.com/content/remote-command-line-debugging-phpstorm-phpdrupal-including-drush