Docker+PhpStorm+Xdebug调试问题：.env变量无法读取

以下是针对性的解决思路，按优先级排查：

1. 检查PhpStorm远程CLI解释器的环境变量配置 #

• 打开Settings/Preferences > Languages & Frameworks > PHP > CLI Interpreter，选中对应Docker容器的远程SSH解释器
• 切换到Environment Variables标签：
  • 确保勾选Include system environment variables，让PhpStorm继承容器内的系统环境变量
  • 若勾选后仍缺失变量，可手动添加指定变量（如POSTGRES_PASS），值填写容器内对应的变量值

2. 调整PhpStorm启动CLI的Shell模式 #

PhpStorm通过SSH启动调试时，默认可能使用非登录Shell，导致容器内全局环境变量未加载：

• 在CLI解释器配置的Configuration标签中，将PHP executable字段改为bash -l -c "php"（强制加载登录Shell的环境配置）
• 测试效果：运行打印$_ENV的脚本，对比容器SSH直接执行的输出，确认变量是否补全

3. 检查调试会话的环境变量传递 #

• 打开对应CLI脚本的调试配置（Run/Debug Configurations），切换到Environment标签
• 确认Environment variables未设置清除或覆盖目标变量的规则，保持默认或手动添加缺失变量

4. 排查Xdebug配置是否存在变量过滤 #

• 进入容器查看Xdebug配置文件（通常路径：/usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini）
• 确认未配置xdebug.env相关过滤参数，Xdebug默认不会清除环境变量，但自定义配置可能引发异常

5. 验证容器内环境变量的全局有效性 #

虽SSH执行CLI能拿到变量，仍需确认：

• docker-compose的env_file或environment配置是全局作用于容器，而非仅FPM进程
• 容器内环境变量可在所有Shell会话中读取（执行printenv | grep POSTGRES_PASS验证）

内容的提问来源于stack exchange，提问作者Tom Raganowicz