Xdebugging! https://enrise.com/2018/02/debugging-php-with-xdebug/

docker_cli_debug.sh

docker exec -ti \
  -e PHP_IDE_CONFIG="serverName=local.project.cli" \
  -e XDEBUG_CONFIG="idekey=PHPSTORM" \
  my_container php /app/index.php

docker_compose_cli_debug.sh

docker-compose exec my_container php /app/index.php

docker_compose_network.yml

networks:
  default:
    driver: bridge
    ipam:
      driver: default
      config:
      - subnet: 192.168.xx.0/24
        gateway: 192.168.xx.1

docker_compose_xdebug.yml

services:
  my_container:
    environment:
      PHP_IDE_CONFIG: serverName=local.project.cli
      XDEBUG_CONFIG: idekey=PHPSTORM

docker_lookup_gateway.sh

docker network inspect my_network | grep GateWay

docker_lookup_network.sh

docker inspect my_container | grep NetworkMode

launch.json

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Listen for XDebug",
            "type": "php",
            "request": "launch",
            "port": 9000,
            "serverSourceRoot": "/var/www/myproject",
            "localSourceRoot": "/home/nico/Projects/myproject"
        },
        {
            "name": "Launch currently open script",
            "type": "php",
            "request": "launch",
            "program": "${file}",
            "cwd": "${fileDirname}",
            "port": 9000
        }
    ]
}

vagrant_cli_debug.sh

vagrant ssh -c "XDEBUG_CONFIG=\"idekey=PHPSTORM\" PHP_IDE_CONFIG=\"serverName=local.myproject.cli\" /vagrant/app/console my-app:my-command"

Vagrantfile

config.vm.network 'private_network', ip: '192.168.56.100'

xdebug.sls

php-xdebug:
  pkg.installed

/etc/php/7.1/fpm/conf.d/20-xdebug.ini:
  file.managed:
    - contents: |
        zend_extension=xdebug.so
        xdebug.remote_connect_back=0
        xdebug.remote_host=192.168.56.1
        xdebug.remote_enable=1
        xdebug.remote_port=9000
    - require:
      - pkg: php-xdebug

xdebug_config_docker.conf

zend_extension=xdebug.so

xdebug.remote_enable=1
xdebug.remote_connect_back=0
xdebug.remote_host=<gateway_ip>
xdebug.remote_port=9000

xdebug_config_docker_osx.conf

zend_extension=xdebug.so

xdebug.remote_enable=1
xdebug.remote_connect_back=0
xdebug.remote_host=docker.for.mac.localhost
xdebug.remote_port=9000

xdebug_config_docker_win.conf

zend_extension=xdebug.so

xdebug.remote_enable=1
xdebug.remote_connect_back=0
xdebug.remote_host=docker.for.win.localhost
xdebug.remote_port=9000

xdebug_config_remote_tunnel.conf

zend_extension=xdebug.so

xdebug.remote_enable=1
xdebug.remote_connect_back=0
xdebug.remote_host=127.0.0.1
xdebug.remote_port=9000

xdebug_config_vagrant.conf

zend_extension=xdebug.so

xdebug.remote_enable=1
xdebug.remote_connect_back=0
xdebug.remote_host=192.168.56.1
xdebug.remote_port=9000

xdebug_vagrant_oneline_install.sh

vagrant ssh -c "sudo apt install php-xdebug && printf 'zend_extension=xdebug.so\nxdebug.remote_connect_back=0\nxdebug.remote_host=192.168.56.1\nxdebug.remote_enable=1\nxdebug.remote_port=9000\n' | sudo tee /etc/php/*/mods-available/xdebug.ini && sudo phpenmod xdebug"

xdebug_vagrant_validate.sh

vagrant ssh -c "php -i | grep 'xdebug'"