VagrantXDebug.md

Configure

xdebug.ini

/etc/php/7.1/mods-available/xdebug.ini <--inside the vagrant box

xdebug.remote_enable=1
xdebug.remote_handler=dbgp
xdebug.remote_port=9000
xdebug.remote_autostart=1
xdebug.remote_connect_back=1
xdebug.idekey=vagrant     
xdebug.remote_host=10.0.2.2

The remote_host is the IDE's host ip from the vagrant box. 10.0.2.2 seems to be the default...i think, works for me.

In PHPStorm

Setup Server

Add Debug Configuration

Run > Edit Configurations...

Browser - Start Debugging

Create a bookmarket - use IDE Key VAGRANT (as above)

https://www.jetbrains.com/phpstorm/marklets/

Set a breakpoint

Click Listen for Debug Connections in Tool Bar

Click Bookmarket in Browser

Load page

Command Line - Start Debugging

Run > Debug...

Set a breakpoint

Run your command, then switch to PHPStorm

Profit!