Eclipse中以PHP CLI应用调试时无法触发断点（使用Zend Xdebug）

核心排查与修复步骤 #

1. 修正Xdebug扩展路径 #

你当前php.ini里的zend_extension指向WAMP原目录的DLL，但PHP已经复制到c:\Prog\php8.0.26\，必须同步迁移Xdebug DLL并更新路径：

• 复制c:\wamp64\bin\php\php8.0.26\zend_ext\php_xdebug-3.1.6-8.0-vs16-x86_64.dll到c:\Prog\php8.0.26\zend_ext\（无此文件夹则新建）
• 修改php.ini中的扩展路径：

zend_extension="c:/Prog/php8.0.26/zend_ext/php_xdebug-3.1.6-8.0-vs16-x86_64.dll"

2. 补充Xdebug 3.x调试必需配置 #

在[xdebug]段添加以下参数，确保调试会话能正常启动并连接Eclipse：

xdebug.client_host=localhost
xdebug.client_port=9003
xdebug.start_with_request=yes

• xdebug.start_with_request=yes：强制脚本启动时自动触发调试会话，避免手动触发失效
• client_host和client_port对应Eclipse默认调试端口，可在Window->Preferences->PHP->Debug->Xdebug中确认是否一致

3. 验证PHP与Xdebug加载状态 #

打开命令行，切换到c:\Prog\php8.0.26\目录执行：

php -v

输出中若包含Xdebug版本信息，说明扩展加载成功；若报错，检查php.ini语法错误或DLL路径是否正确。

4. 检查Eclipse调试配置正确性 #

• 确认调试配置使用的是新PHP环境：右键调试配置 → PHP CLI Application → 选中你的配置 → 查看「PHP Executable」是否指向c:\Prog\php8.0.26\php.exe
• 取消跳过调试选项：在调试配置的「Debugger」标签页，确保未勾选「Run without debugging」

5. 清理调试缓存与日志 #

• 关闭Eclipse，删除工作区下的.metadata/.plugins/org.eclipse.dltk.core目录（建议先备份），重启后重新加载配置
• 清空c:/wamp64/logs/xdebug.log，重新触发调试，查看日志中是否有连接失败、端口占用等错误信息

6. 排查端口占用问题 #

打开命令行执行：

netstat -ano | findstr :9003

若有结果，说明9003端口被占用，可在Eclipse中修改调试端口（Window->Preferences->PHP->Debug->Xdebug，改为9004等未占用端口），同时同步修改php.ini中的xdebug.client_port参数。

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