![\"Docker](\"http:\/\/magebrew.com\/blog\/wp-content\/uploads\/2017\/03\/docker_xdebug-1024x480.png\")
<\/p>\nNo so long ago I’ve started using Docker as my primary\u00a0development environment. Before that I had\u00a0everything (WEB-server, PHP, MySql, etc) installed\u00a0on my Mac and being run natively. Docker brings more flexibility and it is just fun. So now my setup includes Mac OS with PhpStorm installed and\u00a0remote Ubuntu server running Docker containers needed for my WEB application.<\/p>\n
<\/p>\n
Official PHP5.6-FPM is missing some extensions, so we extend it and build our own. Dockerfile for PHP service:<\/p>\n
FROM php:5.6-fpm\r\n\r\nRUN apt-get -qq update && apt-get -qq install libxml++2.6-dev > \/dev\/null\r\nRUN apt-get update && apt-get install -y \\\r\n libfreetype6-dev \\\r\n libcurl4-gnutls-dev \\\r\n build-essential \\\r\n libtool \\\r\n uuid-dev \\\r\n libsodium-dev \\\r\n libjpeg62-turbo-dev \\\r\n libpng12-dev \\\r\n && docker-php-ext-configure gd --with-freetype-dir=\/usr\/include\/ --with-jpeg-dir=\/usr\/include\/ \\\r\n && docker-php-ext-install -j$(nproc) gd mbstring mysql mysqli pdo pdo_mysql soap\r\n\r\nRUN apt-get install -y libmcrypt-dev\r\nRUN docker-php-ext-install mcrypt\r\n\r\nRUN apt-get install -y libicu-dev\r\nRUN pecl install intl\r\nRUN docker-php-ext-install intl\r\nRUN yes | pecl install xdebug \\\r\n && echo \"zend_extension=$(find \/usr\/local\/lib\/php\/extensions\/ -name xdebug.so)\" > \/usr\/local\/etc\/php\/conf.d\/xdebug.ini \\\r\n && echo \"xdebug.remote_enable=on\" >> \/usr\/local\/etc\/php\/conf.d\/xdebug.ini \\\r\n && echo \"xdebug.remote_port=9001\" >> \/usr\/local\/etc\/php\/conf.d\/xdebug.ini \\\r\n && echo \"xdebug.remote_connect_back=0\" >> \/usr\/local\/etc\/php\/conf.d\/xdebug.ini \\\r\n && echo \"xdebug.idekey=PHPSTORM\" >> \/usr\/local\/etc\/php\/conf.d\/xdebug.ini \\\r\n && echo \"xdebug.remote_log='\/tmp\/xdebug_log\/xdebug.log'\" >> \/usr\/local\/etc\/php\/conf.d\/xdebug.ini<\/pre>\nAs you can see there are some xdebug settings. I have set remote port to 9001 and enabled xdebug logging so it will be easier to check if it works (don’t forget to turn it off later).
\nNow lets take a look at docker-compose.yml file:<\/p>\nversion: '2'\r\nservices:\r\n nginx:\r\n image: nginx:latest\r\n ports:\r\n - \"8080:80\"\r\n volumes:\r\n - .\/source:\/source\r\n - .\/nginx.conf:\/etc\/nginx\/conf.d\/default.conf\r\n depends_on:\r\n - php\r\n php:\r\n build: .\/php\r\n environment:\r\n XDEBUG_CONFIG: \"remote_host=172.17.0.1\"\r\n volumes:\r\n - .\/source:\/source\r\n - .\/logs:\/tmp\/xdebug_log\r\n db:\r\n image: mariadb:latest\r\n volumes:\r\n - db_data:\/var\/lib\/mysql\r\n environment:\r\n MYSQL_DATABASE: 'test'\r\n MYSQL_USER: 'root'\r\n MYSQL_PASSWORD: 'test'\r\n MYSQL_ALLOW_EMPTY_PASSWORD: 'yes'\r\nvolumes:\r\n db_data:<\/pre>\nImportant part here is to set xdebug remote host in\u00a0environment variables. To get correct IP address you can run ifconfig<\/em> command and find what IP address is used by\u00a0docker0<\/em> interface. Alternatively use\u00a0the following command in container:<\/p>\n
\/sbin\/ip route|awk '\/default\/ { print $3 }'<\/pre>\nAlso set 777 permissions to logs<\/em> folder.<\/p>\n
Now we can execute docker-compose run<\/em> to build and run our services.<\/p>\n
Lets check if xdebug can connect to remote host using netcat<\/em> tool. Leave this command running in console and navigate to some php script with xdebug trigger<\/a>\u00a0turned on:<\/p>\n
netcat -l 9001<\/pre>\nIf you see something like this then it is ok:<\/p>\n
<?xml version=\"1.0\" encoding=\"iso-8859-1\"?>\r\n<init xmlns=\"urn:debugger_protocol_v1\" xmlns:xdebug=\"http:\/\/xdebug.org\/dbgp\/xdebug\" fileuri=\"file:\/\/\/source\/info.php\" language=\"PHP\" xdebug:language_version=\"5.6.27\" protocol_version=\"1.0\" appid=\"6\" idekey=\"XDEBUG_ECLIPSE\"><engine version=\"2.5.1\"><![CDATA[Xdebug]]><\/engine><author><![CDATA[Derick Rethans]]><\/author><url><![CDATA[http:\/\/xdebug.org]]><\/url><copyright><![CDATA[Copyright (c) 2002-2017 by Derick Rethans]]><\/copyright><\/init><\/pre>\nIf it is not – check xdebug log file.<\/p>\n
Next step is to create SSH-tunnel<\/a> and configure PhpStorm.<\/p>\n
On working computer run the following command to create\u00a0SSH-tunnel:<\/p>\n
ssh -R 9001:localhost:9001 ubuntu@your.remote.host.ip.address.here<\/pre>\nIn PhpStorm set debug port to 9001:<\/p>\n
![\"Preferences](\"http:\/\/magebrew.com\/blog\/wp-content\/uploads\/2017\/03\/PreferencesPHPstorm.png\")
<\/a><\/p>\n