@ A resposta de KAndy me colocou no caminho certo, mas estou desenvolvendo localmente usando vagrant e tive que fazer o seguinte para fazer com que isso funcionasse 1
Configure o Xdebug:
zend_extension=xdebug.so
xdebug.remote_enable = 1
;remote_connect_back will fail because REMOTE_ADDR header won’t be set
xdebug.remote_connect_back = 1
xdebug.remote_autostart = 1
xdebug.idekey = "PHPSTORM"
;remote_host is ignored when remote_connect_back is enabled & successful; fallback
;Set to your HOST MACHINE IP
xdebug.remote_host=xx.xx.xx.xx
;provides valuable insight if you can’t connect. Remove when done.
xdebug.remote_log="/tmp/xdebug.log"
Defina o remote_hostIP como o endereço IP do host (para mim, o uso do endereço IP da ifconfigmáquina convidada não funcionou - o endereço IP usado adquirido das configurações de rede da máquina host como o remote_host).
Configurar PHP Storm
- Configure um servidor em
Settings -> Languages and Frameworks -> PHP -> Serverscaso ainda não o tenha feito. (Veja a captura de tela)
Run -> Edit Configurations e adicione um PHP Remote Debug.
- Escolha o servidor que você criou no # 1
- Defina a chave IDE para PHPSTORM

- (Opcional)
Settings -> Languages and Frameworks -> PHP -> DebugMarque "Interromper na primeira linha nos scripts PHP" (isso pode ajudar a depurar problemas com o mapeamento de caminhos).
Run -> Debug Vagrant (ou o que você nomeou sua configuração na Etapa 2)
- Execute o script que você deseja depurar (
magento setup:upgradeno meu caso)
1 Estou usando o ubuntu / trusty64 como referência