如何从CLI及Docker调试PHP代码？IntelliJ Xdebug连接问题求助

你的猜测完全没错——你现在用的是Mac主机本地的PHP环境来运行脚本，而不是Docker容器里的PHP，这就导致容器外的PHP没有配置对应的Xdebug参数，自然没法和IntelliJ的监听会话建立连接。下面是具体的解决步骤：

第一步：确认当前PHP环境归属 #

先在终端里执行这个命令，看看你用的是主机还是容器的PHP：

which php

如果输出是类似 /usr/bin/php 这样的Mac本地路径，那确实是在用主机的PHP，这就是问题根源。

第二步：切换到Docker容器内运行脚本 #

你需要让脚本在Docker Ubuntu容器里执行，才能用上容器里配置好Xdebug的PHP环境，有两种方式：

方式1：进入容器交互模式运行 #

1. 先进入你的Docker容器（替换成你的容器名或ID）：

   docker exec -it <你的容器名称/ID> bash
   

2. 切换到脚本所在的目录（如果是主机挂载到容器的目录，比如你把主机项目目录挂到了容器的 /var/www/html，就cd到这里）：

   cd /path/to/your/script
   

3. 运行脚本：

   php -f myscript.php
   

方式2：直接在主机终端通过docker exec运行（更高效） #

不用进入容器，直接在主机终端执行这条命令（替换容器名和容器内脚本路径）：

docker exec <你的容器名称/ID> php -f /path/to/inside/container/myscript.php

第三步：确保容器内的Xdebug配置正确 #

虽然你说IntelliJ已经配置监听Docker，但容器里的Xdebug得对应配置好才能连上主机的IntelliJ：

1. 找到容器内的PHP配置文件（比如 /etc/php/7.0/cli/conf.d/20-xdebug.ini，具体路径根据你容器里的PHP版本调整）
2. 添加或修改以下配置（Xdebug 3版本为例，如果你用的是Xdebug2，端口改成9000，参数名略有不同）：

   xdebug.mode=debug
   xdebug.client_host=host.docker.internal  # Mac上Docker可以用这个特殊域名访问主机
   xdebug.client_port=9003  # 和IntelliJ里设置的监听端口一致
   xdebug.start_with_request=yes
   xdebug.idekey=PHPSTORM  # 和IntelliJ配置的IDE Key保持一致
   

3. 保存配置后，CLI模式下的PHP不需要重启服务，直接生效。

第四步：验证调试会话 #

1. 打开IntelliJ，确保右上角的“Start Listening for PHP Debug Connections”按钮（电话图标）是亮着的
2. 在你的脚本里设置断点
3. 用上面的方法在容器内运行脚本，IntelliJ应该会自动捕获到调试会话，进入断点调试模式。

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