How to debug docker container with PhpStorm

Question

Can't debug the web app with the following configuration:

Dockerfile:

FROM php:7-fpm

RUN yes | pecl install xdebug \
    && echo "zend_extension=$(find /usr/local/lib/php/extensions/ -name 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_autostart=0" >> /usr/local/etc/php/conf.d/xdebug.ini \
    && echo "xdebug.remote_host=site.dev" >> /usr/local/etc/php/conf.d/xdebug.ini \
    && echo "xdebug.remote_log=/var/www/site/xdebug.log" >> /usr/local/etc/php/conf.d/xdebug.ini

WORKDIR /var/www/site

nginx server (site.conf):

server {
    server_name site.dev www.site.dev;
    root /var/www/site/src/UI/Web/Silex/Public;
    ...
}

docker-compose.yml:

version: '2'
services:
    php:
        container_name: acme_php
        build: etc/docker/development/php
        volumes:
            - ./:/var/www/site
    nginx:
        container_name: acme_nginx
        build: etc/docker/development/nginx
        ports:
            - "80:80"
        volumes:
            - ./:/var/www/site
            - ./etc/docker/development/nginx/site.conf:/etc/nginx/conf.d/site.conf
        links:
            - php

Running the server:

docker-compose up -d --build

Server:

Debug:

Run/Debug configurations:

Pressing bug button opens chrome but doesn't stop in the breakpoint:

Running phpinfo() looks like (xdebug area):

xdebug.log:

I: Connecting to configured address/port: site.dev:9000.
I: Connected to client. :-)
-> <init xmlns="urn:debugger_protocol_v1" xmlns:xdebug="http://xdebug.org/dbgp/xdebug" fileuri="file:///var/www/site/src/UI/Web/Silex/Public/index.php" language="PHP" xdebug:language_version="7.1.5" protocol_version="1.0" appid="6" idekey="18032"><engine version="2.5.4"><![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>

-> <response xmlns="urn:debugger_protocol_v1" xmlns:xdebug="http://xdebug.org/dbgp/xdebug" status="break" reason="ok"><xdebug:message filename="file:///var/www/site/src/UI/Web/Silex/Public/index.php" lineno="5"></xdebug:message></response>

-> <response xmlns="urn:debugger_protocol_v1" xmlns:xdebug="http://xdebug.org/dbgp/xdebug" status="stopping" reason="ok"></response>

Why it is not stopping in the breakpoint? :(

1) Collect xdebug log to see what is happening (where it tries to connect .. if at all) 2) Try specifying IP address of client computer (where IDE runs) manually (in case if it cannot detect correct one) 3) try with xdebug_break(); in your code 4) Maybe it does not see your "debug this" marker (cookie/query param)? Try with xdebug.remote_autostart = 1 5) Firewall? Ensure that IDE can receive incoming requests on xdebug port (it's xdebug that connects to IDE and not other way around) — LazyOne
– LazyOne, Commented May 17, 2017 at 18:56
BTW -- "PHP | Servers" -- "Host" field should not contain any http:// stuff -- just a domain name. ALSO -- you should close other debug tabs -- maybe it's debugging one of them already..? — LazyOne
– LazyOne, Commented May 17, 2017 at 18:59
1) Dont know where xdebug log file is 2) Where I should specify this IP 3) Don't see any output doing this 4) done 5) I can listen PHP Debug connections. Host field fixed "site.dev" now. Same, doesn't stop in the breakpoint — jj-aa
– jj-aa, Commented May 17, 2017 at 19:17
1) xdebug.org/docs/all_settings#remote_log 2) xdebug.org/docs/all_settings#remote_host 3) xdebug.org/docs/all_functions — LazyOne
– LazyOne, Commented May 17, 2017 at 19:51
No concrete idea. Could be firewall. Could be wrong IP (unlikely, but double check). Try different port (e.g. 9001 in both xdebug and PhpStorm settings). BTW -- on Mac IDE is unable to recognize who listens on xdebug port (cannot tell if it's busy already). You may check output of sudo lsof -nP -iTCP -sTCP:LISTEN to see who listens on xdebug port — LazyOne
– LazyOne, Commented May 17, 2017 at 20:37

jj-aa · Accepted Answer · 2017-05-17 22:59:17Z

2

Changes to make it work:

Dockerfile:

FROM php:7-fpm

RUN yes | pecl install xdebug \
    && echo "zend_extension=$(find /usr/local/lib/php/extensions/ -name 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_autostart=0" >> /usr/local/etc/php/conf.d/xdebug.ini \

WORKDIR /var/www/site

docker-compose.yml:

version: '2'
services:
    php:
        container_name: acme_php
        build: etc/docker/development/php
        volumes:
            - ./:/var/www/site
        links:
            - db
        environment:
          XDEBUG_CONFIG: "remote_host=192.168.1.99"
          PHP_IDE_CONFIG: "serverName=site.dev"
    nginx:
        container_name: acme_nginx
        build: etc/docker/development/nginx
        ports:
            - "80:80"
        volumes:
            - ./:/var/www/site
            - ./etc/docker/development/nginx/site.conf:/etc/nginx/conf.d/site.conf
        links:
            - php

/etc/hosts (host machine):

127.0.0.1 site.dev

Thanks for all the help in your comments @LazyOne

answered May 17, 2017 at 22:59

jj-aa

1,0395 gold badges19 silver badges41 bronze badges

Sign up to request clarification or add additional context in comments.

1 Comment

LazyOne Over a year ago

So .. in the end it basically was the wrong IP address of the computer where IDE is running (xdebug.remote_host .. which you set now a bit differently)... OK. Good to know.

maccevedor · Accepted Answer · 2020-01-16 14:55:27Z

0

I had the same problem , my config:

Ubuntu 19.10
Visual Code
Docker version 19.03.5 docker-compose
docker-compose version 1.25.0

add this Dockerfile: :

echo "xdebug.remote_connect_back=1" >> /usr/local/etc/php/conf.d/xdebug.ini &&

Info:

Xdebug for remote server not connecting

answered Jan 16, 2020 at 14:55

maccevedor

1652 silver badges7 bronze badges

Collectives™ on Stack Overflow

How to debug docker container with PhpStorm

2 Answers 2

1 Comment

Comments

Your Answer

Linked

Hot Network Questions

Collectives™ on Stack Overflow

2 Answers 2

1 Comment

Comments

Your Answer

Sign up or log in

Post as a guest

Linked

Related