Docker环境下Web端Xdebug正常，CLI调试Symfony命令断点失效

你的Xdebug配置仅对PHP-FPM（Web请求场景）生效，而CLI模式下的PHP使用独立的配置目录，当前并未加载你的Xdebug配置，这就是命令行调试失效的核心原因。

1. 同步Xdebug配置到CLI环境 #

修改docker-compose.yml中php-fpm服务的volumes节点，添加对CLI配置目录的挂载，让命令行模式的PHP也能读取到Xdebug配置：

php-fpm:
  build: phpdocker/php-fpm
  container_name: my-php-fpm
  working_dir: /application
  environment:
    PHP_IDE_CONFIG: "serverName=myServer"
  volumes:
    - .:/application
    - ./phpdocker/php-fpm/php-ini-overrides.ini:/etc/php/7.4/fpm/conf.d/99-overrides.ini
    # 新增该行，将配置同步到CLI配置目录
    - ./phpdocker/php-fpm/php-ini-overrides.ini:/etc/php/7.4/cli/conf.d/99-overrides.ini
  extra_hosts:
    - "host.docker.internal:host-gateway"

2. 验证CLI环境的Xdebug配置 #

重启容器后，进入php-fpm容器执行以下命令，确认Xdebug已正确加载：

# 进入容器
docker exec -it my-php-fpm bash

# 检查Xdebug是否加载成功
php -v
# 正常输出中会包含Xdebug的版本信息

# 查看Xdebug具体配置参数
php -i | grep xdebug
# 确认xdebug.mode=debug、xdebug.client_host等参数与你的配置一致

3. 调试Symfony命令的注意事项 #

• 确保你的IDE（如PHPStorm）已开启调试连接监听
• 直接在容器内执行Symfony命令即可触发调试，例如：

php bin/console your:target:command

由于配置了xdebug.start_with_request=yes，命令执行时会自动发起Xdebug连接请求到你的IDE。

如果仍无法触发断点，可以额外检查：

• 宿主机的9003端口是否被其他进程占用
• 在容器内执行ping host.docker.internal，确认该地址能正确解析到宿主机IP

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