CodeLite等待XDebug连接失败，PHP调试卡滞问题求助

1. 解决XDebug重复加载问题 #

• 排查所有PHP配置文件（php.ini及/etc/php/7.3/conf.d/下的xdebug相关文件），确保仅在一个文件中声明zend_extension = /usr/lib/php/20180731/xdebug.so
• 重启PHP内置服务器，确认不再输出Cannot load Xdebug - it was already loaded提示

2. 配置CodeLite文件映射 #

• 打开CodeLite，进入项目设置 → 调试面板
• 添加文件映射规则：将服务器端路径/home/daniel/Dokumente/Code/homepage/test/映射到本地相同路径（本地调试场景下两端路径一致）
• 保存设置，消除断点失效警告

3. 修复Header may not contain NUL bytes错误 #

• 打开test.php第一行，检查是否存在不可见空字符（NUL字节）
  • 使用文本编辑器的「显示所有字符」功能查看并删除空字符
  • 若文件编码异常，重新保存为UTF-8无BOM格式

4. 优化XDebug配置（适配PHP 7.3 + XDebug 2.7） #

更新php.ini中的XDebug配置：

[XDebug]
xdebug.remote_enable=1
zend_extension = /usr/lib/php/20180731/xdebug.so
xdebug.idekey="codeliteide"
xdebug.remote_host=127.0.0.1
xdebug.remote_port=9000
xdebug.remote_log = /tmp/xdebug.log  # 使用绝对路径避免权限问题
xdebug.remote_autostart=1  # 自动触发调试会话，无需手动传参
xdebug.remote_connect_back=0  # 强制连接配置的remote_host，避免连接异常

5. 修正调试启动流程 #

1. 先启动CodeLite的「等待调试器连接」功能
2. 启动PHP内置服务器时更换端口（避免与XDebug默认端口冲突）：

   php -S 127.0.0.1:8000 -t .
   

3. 在浏览器中访问http://127.0.0.1:8000/test.php（因配置了remote_autostart，无需手动添加XDEBUG_SESSION参数）

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