Business
Jobs
  • About Us
  • Solutions
    • Job Postings
      Post your job and receive qualified candidates in 48h.
    • Candidate Assessments
      500+ technical and psychological tests, plus anti-fraud.
    • Headhunting
      Tailor-made executive search from start to finish.
    • Payroll + EOR
      Payroll dispersal and EOR across 15+ LATAM countries.
  • Pricing
  • Jobs

0

422
Views
Xdebug (inside Docker container) ignoring XDEBUG_CONFIG environment variable

I'm running a PHP application on Docker and I'd like to debug it using XDebug. In my docker-compose I added the following lines in the phpfpm part:

environment:
      XDEBUG_CONFIG: "remote_enable=1 remote_host=192.168.110.29 remote_port=9000 idekey=PHPSTORM remote_autostart=1"
      PHP_IDE_CONFIG: "serverName=reports.dev"

I configured PHPStorm in the right way, listening on port 9000 and ran the application.

The application works flawlessly but XDebug doesn't seem to be working.

If I move the lines of configuration inside the php.ini file the debugger works, except for the fact that Server Name is empty and I cannot debug (that's why I tried following the docker-compose configuration way).

If, inside the docker container, I run echo $XDEBUG_CONFIG the output is right, but XDebug seems not to read that Env variable.

about 4 years ago · Santiago Trujillo
3 answers
Answer question

0

I had the same problem. My image was based on nimmis/alpine-apache-php7/. I found that the image was using supervisor to start processes. supervisor has no knowledge of the Docker environment variables.

The convention to tell supervisor that a process needs to be run, is to create a run script at /etc/sv/{process}/run. A script like this was used to start Apache. I needed to change the script so that it would import Docker environment variables before starting Apache.

The docs for the base image explain the convention for importing Docker environment:

If you need environment variables from the docker command line (-e,--env=[]) add

source /etc/envvars

before you use them in the script file

So I created my own custom run script for Apache — I added source /etc/envvars just before execution of httpd.

I overwrote the original run script, by adding a simple COPY to my Dockerfile:

COPY apache-run.sh /etc/sv/apache2/run

This successfully ensured that my $XDEBUG_CONFIG was visible to httpd at the time it was launched. I was able to confirm that this affected my PHP configuration, by printing phpinfo(); in a webpage.

about 4 years ago · Santiago Trujillo Report

0

Did you do a phpinfo();? That should tell you the settings used.

I had the same problem... took me forever to figure out. Are you using xdebug.remote_connect_back=1? If so remove that line.

My nginx proxy was forwarding an IP through (which was wrong) and so the ip set in XDEBUG_CONFIG was being ignored.

about 4 years ago · Santiago Trujillo Report

0

For me it was a different problem using the official PHP-FPM-Alpine docker image (FROM php:7-fpm-alpine)

I needed to add the XDEBUG-CONFIG to the fpm pool config: env[XDEBUG_CONFIG] = $XDEBUG_CONFIG

See full config https://github.com/attrib/docker-symfony

about 4 years ago · Santiago Trujillo Report
Answer question
Find remote jobs

Discover the new way to find a job!

Top jobs
Top job categories
Business
Post vacancy Pricing Sales
Legal
Terms and conditions Privacy policy
© 2026 PeakU Inc. All Rights Reserved.
Andres GPT
Show me some job opportunities
There's an error!