#Phpstorm docker xdebug install

So your local machine, actually your IDE, will be the server part of Xdebug in this scenario. When a user - you - initiate a request and Xdebug is ON, it will need to establish a connection somewhere, usually back to the request initiator. So, how does Xdebug work? Basically, what we installed in the image is a PHP extension, it is the client part of XDebug. The solution is actually pretty straight forward, but that’s an interesting part to understand. The tricky part actually comes here, we have to understand how Xdebug works, and how Docker networking works. Now to the configuration, it’s not going to work out of the box. $ docker-compose up -d -build $ docker-compose exec app php -v PHP 8.1.6 (cli) (built: 08:14:41) (NTS) Copyright (c) The PHP Group Zend Engine v4.1.6, Copyright (c) Zend Technologies with Xdebug v3.1.4, Copyright (c) 2002-2022, by Derick Rethans I am using docker-compose here for the sake of simplicity, but you can adapt this to a standalone docker run, just don’t forget to rebuild the container.

#Phpstorm docker xdebug install

I’m using to install the PHP extension, feel free to install it with your preferred method, but if you don’t know this installer you should definitely take a look at it! Now let’s add Xdebug inthere COPY -from=mlocati /php-extension-installer /usr /bin /install-php-extensions /usr /bin / RUN install-php-extensions xdebug It is missing quite a few things to make our app actually work, but I’m only showing the relevant parts. FROM php:8.1 -apache WORKDIR /var /www /html So, let’s consider this simple Dockerfile as our base. I’ll use a very simple Dockerfile to showcase, but you might have to adapt this to your actual stack. docker/nginx/config:/etc/nginx/conf.Alright, first things first, Xdebug needs to be installed in the Docker image you use. docker/nginx/.htpasswd:/etc/nginx/.htpasswd:ro I was missing the network configuration in my docker-composer.yaml file, I added and now it looks like so: version: '3.7' Java 4566 myuser 54u IPv6 543552 0t0 TCP *:9003 (LISTEN)Īnd the problem seems to be in the host machine, I also tried to access the 9003 of the host from the container with no success.Īnyone knows what can be going on and what else could I test? Any help would be much appreciated :-) Sudo lsof -i -P -n | grep LISTEN | grep 9003 I also checked that is PHP Storm who is listening Nmap scan report for localhost (127.0.0.1) Open my 9003 port in my host machine, according to nmap is open: Tried: :9003 (fallback through xdebug.client_host/xdebug.client_port) :-(Ĭhange client host. That's with PHP storm, if I do it directly in the container: Could not connect to debugging client.

When I try to execute any php script either with phpstorm or direcly in the container with bash I get this error: Xdebug: Could not connect to debugging client. docker/php/conf.d/error_reporting.ini:/usr/local/etc/php/conf.d/error_reporting.ini docker/php/conf.d/xdebug.ini:/usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini

I have a php container with xdebug installed in a Ubuntu 20.04 laptop: rest-example-php-8: I've been struggling with this for some time and here I am :-)