树莓派PHP5-FPM环境下Xdebug无法连接9000端口问题排查

从你给出的phpinfo()信息和操作步骤来看，已经做了常规的调试配置，但还是没触发Xdebug连接，下面是一些容易被忽略的排查点：

• PHP5-FPM 默认端口与Xdebug端口冲突
  PHP5-FPM 默认的监听端口也是9000，如果你的PHP-FPM配置里是用端口监听（而非Unix Socket），那Xdebug尝试连接127.0.0.1:9000时，实际连接的是PHP-FPM进程，而非你用nc监听的调试端口。
  检查PHP-FPM的 pool 配置文件（通常是/etc/php5/fpm/pool.d/www.conf）里的listen参数：

  • 如果是listen = 127.0.0.1:9000，请把Xdebug的xdebug.remote_port改成其他未被占用的端口（比如9001），同时更新nc -l 9001的监听端口，重启PHP5-FPM后再测试。
  • 如果是listen = /var/run/php5-fpm.sock，那端口冲突问题可以排除。

• Xdebug日志文件权限不足
  你配置了xdebug.remote_log=/var/log/xdebug.log但没有日志生成，大概率是PHP-FPM的运行用户（www-data）没有写入/var/log目录的权限。执行以下命令手动创建日志并设置权限：

  sudo touch /var/log/xdebug.log
  sudo chown www-data:www-data /var/log/xdebug.log
  sudo service php5-fpm restart
  

  再次访问调试页面后，日志里会详细记录Xdebug尝试连接的过程，帮你定位具体失败原因。

• IDE Key 未正确配置或传递
  你的phpinfo()显示xdebug.idekey为no value，虽然请求里带了XDEBUG_SESSION=1，但Xdebug 2.2.5版本对IDE Key的匹配要求比较严格。可以尝试两种方式：

  1. 在php.ini或20-xdebug.ini里添加xdebug.idekey = "www-data"（和你phpinfo里显示的IDE Key一致）；
  2. 改用XDEBUG_SESSION_START=www-data作为请求参数（比如http://mysite/mypage.php?XDEBUG_SESSION_START=www-data），强制触发调试会话。

• PHP-FPM Pool 配置覆盖了Xdebug参数
  有些PHP-FPM的pool配置会通过php_admin_value或php_admin_flag覆盖全局的PHP配置，检查/etc/php5/fpm/pool.d/www.conf里是否存在类似以下的配置：

  php_admin_value[xdebug.remote_enable] = off
  

  如果有，注释掉这行并重启PHP5-FPM。

• Xdebug版本过于陈旧
  你使用的Xdebug 2.2.5是2013年的旧版本，存在不少已知的兼容性问题（尤其是和较新的PHP5-FPM版本搭配时）。可以尝试更新到PHP 5.x兼容的最新Xdebug版本（2.5.5是PHP5的最后兼容版本）：

  1. 先卸载现有包：sudo apt remove php5-xdebug；
  2. 从Xdebug官网下载对应PHP版本的源码编译安装（注意匹配PHP的API版本，你的是20131226）。

• 本地防火墙或网络规则拦截
  虽然是本地回环地址（127.0.0.1），但树莓派的iptables或ufw防火墙可能误拦截了9000端口的出站请求。可以临时关闭防火墙测试：

  sudo ufw disable
  # 或者清空iptables规则
  sudo iptables -F
  

  如果测试有效，再添加允许Xdebug连接的规则。

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