View Issue Details

IDProjectCategoryView StatusLast Update
0001971XdebugDocumentationpublic2021-08-18 10:53
ReporteryBoNbedE Assigned Toderick  
PrioritynormalSeverityminorReproducibilityalways
Status closedResolutionfixed 
Target Version3.1dev 
Summary0001971: Let developers know about the clear_env configuration in PHP-FPM
Description

While developing with docker, most developers use the XDEBUG_CONFIG and XDEBUG_MODE to set up xdebug. However, because PHP_FPM has this 'clear_env' configuration set to yes by default, those environment variables are not considered.

Please make sure everyone knows about this in the documentation because otherwise it is very hard to realize why is it that XDEBUG doesn't work.

More specifically, in https://xdebug.org/docs/all_settings I think it would be great to add a mention to this PHP-FPM configuration right next to the first mention of the XDEBUG_CONFIG environment variable at the beginning and also next to XDEBUG_MODE in https://xdebug.org/docs/all_settings#mode

Tagsdebug, Docker, fpm
Operating System
PHP Version7.4.10-7.4.19

Activities

yBoNbedE

2021-05-05 15:01

reporter   ~0005871

One thing you can do if you are running into the same issue with 'clear_env' is to create a file *.conf with this content:

clear_env = no

and then run docker like this:

docker run -v $(pwd)/my-configuration.conf:/etc/php/7.4/fpm/conf.d/my-configuration.conf ...

derick

2021-08-18 10:53

administrator   ~0005985

Fixed with https://github.com/xdebug/xdebug.org/commit/986f8bd0b06486a3be3913ffe17ca71f733f5eb3

Issue History

Date Modified Username Field Change
2021-05-05 14:51 yBoNbedE New Issue
2021-05-05 14:51 yBoNbedE Tag Attached: debug
2021-05-05 14:51 yBoNbedE Tag Attached: Docker
2021-05-05 14:51 yBoNbedE Tag Attached: fpm
2021-05-05 15:01 yBoNbedE Note Added: 0005871
2021-06-30 23:45 derick Target Version => 3.1dev
2021-08-07 10:04 derick Status new => confirmed
2021-08-18 10:53 derick Assigned To => derick
2021-08-18 10:53 derick Status confirmed => closed
2021-08-18 10:53 derick Resolution open => fixed
2021-08-18 10:53 derick Note Added: 0005985