PHP 8.0环境下Xdebug 3初始化报错，无法连接调试客户端如何解决？

问题详情 #

PHP 8.0环境中Xdebug 3无法正常启动调试，同一机器上PHP 7.3使用相同配置可正常工作，更换多个端口后问题依旧。日志核心报错：

[Step Debug] Creating socket for '192.168.1.101:10003', poll success, but error: Operation now in progress (29).
[Step Debug] Could not connect to debugging client. Tried: 192.168.1.101:10003 (through xdebug.client_host/xdebug.client_port).

环境参数：

• 系统：Linux Mint 20.3
• PHP版本：8.0.29
• Web服务器：Apache 2.4.41

当前Xdebug配置：

zend_extension=xdebug.so
xdebug.client_host=localhost
xdebug.client_port=10003
xdebug.remote_enable=1
xdebug.remote_connect_back=1
xdebug.mode=debug
xdebug.discover_client_host=false
xdebug.scream=0
xdebug.show_local_vars=1
xdebug.idekey=PHPSTORM
xdebug.start_with_request=yes
xdebug.log=/var/log/xdebug.log

完整Xdebug日志：

[8368] Log opened at 2023-08-06 11:37:58.227380
[8368] [Config] INFO: Systemd Private Temp Directory is enabled (/tmp/systemd-private-7e1a6dcd7e6b41ceb05f74f707b83815-apache2.service-TEbani)
[8368] [Step Debug] INFO: Connecting to configured address/port: localhost:10003.
[8368] [Step Debug] WARN: Creating socket for 'localhost:10003', poll success, but error: Operation now in progress (29).
[8368] [Step Debug] ERR: Could not connect to debugging client. Tried: localhost:10003 (through xdebug.client_host/xdebug.client_port).
[8368] Log closed at 2023-08-06 11:37:58.228415

Xdebug信息页面截图：

解决步骤 #

1. 移除Xdebug 2兼容配置 #

Xdebug 3已废弃xdebug.remote_enable、xdebug.remote_connect_back等旧版参数，这些冗余配置可能引发冲突。修改配置文件，删除以下两行：

xdebug.remote_enable=1
xdebug.remote_connect_back=1

2. 关闭Apache的Systemd私有临时目录 #

日志显示Apache启用了Systemd私有临时目录，这会阻断Xdebug与本地IDE的连接：

1. 编辑Apache服务配置：

   sudo systemctl edit apache2.service
   

2. 在打开的文件中添加：

   [Service]
   PrivateTmp=false
   

3. 保存并重启Apache：

   sudo systemctl restart apache2.service
   

3. 验证IDE监听设置 #

• 确保PHPStorm（或你的调试IDE）已开启调试监听，端口设置为10003，与xdebug.client_port一致。
• 检查系统防火墙，允许10003端口的入站连接。

4. 确认Xdebug版本与PHP 8.0兼容 #

确保安装的Xdebug 3是针对PHP 8.0编译的：

• 执行php -v查看Xdebug版本，或通过xdebug_info()函数检查兼容性。
• 版本不匹配时，重新安装对应版本：

  pecl install xdebug-3.2.2 # 选择兼容PHP 8.0的Xdebug版本
  

5. 测试端口连通性 #

使用nc命令测试10003端口是否可访问：

nc -zv localhost 10003

若提示成功，说明端口正常；若失败，排查IDE监听状态或防火墙规则。

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