Docker: How to use XDebug with docker-compose

Docker

In the docker-compose.yml file create an images/php image

Import:
    build: images/php
    Ports:
        - 80:80
    Volumes:
        - .. /..:/ var/www

find your IP address (ifconfig / ipconfig) – in my example (10.1.0.133)

Create a Dockerfile in the images/php folder

FROM php:7.0.1-apache

RUN yes pecl install -o -f xdebug
          rm -rf /tmp/pear
          "zend_extension/usr/local/lib/php/extensions/no-debug-non-zts-20151012/xdebug.so" - /usr/local/etc/php/conf.d/xdebug.ini
          echo "xdebug.remote_enable on" -usr/local/etc/php/conf.d/xdebug.ini
          Echo "xdebug.remote_host-10.1.0.133" -usr/local/etc/php/conf.d/xdebug.ini
          Echo "xdebug.remote_connect_back-On" -usr/local/etc/php/conf.d/xdebug.ini
          "memory_limit - 64M" - /usr/local/etc/php/conf.d/php.ini
          echo "xdebug.remote_autostart - 1" - usr/local/etc/php/conf.d/xdebug.ini

Once this is done, restart your docker-machine

PhpStorm

In my example, my machine is at IP address: 192.168.99.100

Server configuration

Now PhpStorm will receive the information, and it is possible to debug

Console

If you use the command line, don’t forget to use the variable

Windows:

set PHP_IDE_CONFIG"serverName-docker"

Linux / Mac OS X:

export PHP_IDE_CONFIG"serverName-docker"