PHP8如何配置Xdebug远程调试-php教程-PHP中文网

php 8 配置 xdebug 远程调试需确保 xdebug 3.1+ 版本、php.ini 中设 xdebug.mode=debug、client_host（开发机ip）、client_port=9003，并在 vs code/phpstorm 中配置端口监听与精确路径映射，同时开放服务器防火墙9003端口并验证连接。

php8如何配置xdebug远程调试

PHP 8 配置 Xdebug 远程调试，关键在于确认 Xdebug 版本（必须为 3.1+）、正确设置 php.ini 中的客户端通信参数，并让本地 IDE（如 VS Code 或 PhpStorm）能与远程 PHP 环境建立 DBGp 连接。Xdebug 3 已全面弃用 remote_* 前缀配置，全部改为 client_*，且默认端口为 9003（不是 9000）。

确认 PHP 8 和 Xdebug 3 环境

在远程服务器终端执行：

php -v —— 确认输出含 PHP 8.x（如 8.2、8.3）
php -m | grep xdebug —— 应显示 xdebug，若无则未加载
php --ri xdebug —— 查看详细信息，确认版本为 3.1.0 或更高；若显示 v2.x，需卸载并升级
php --ini —— 找到正在使用的 php.ini 路径（注意：CLI 和 Web SAPI 可能不同，调试通常依赖 CLI 或 FPM 的配置）

修改 php.ini 启用远程调试（Xdebug 3）

在 php.ini 末尾添加以下内容（根据实际环境调整）：

zend_extension=xdebug.so —— 路径需准确，可用 find /usr -name "xdebug.so" 2>/dev/null 查找
xdebug.mode=debug —— 必填项，仅设 zend_extension 不会启动调试
xdebug.start_with_request=yes —— 每次请求自动触发调试（适合开发），也可设为 trigger 配合浏览器插件手动触发
xdebug.client_host=192.168.40.100 —— 填你本地开发机（IDE 所在机器）的局域网 IP，不是服务器自身 IP
xdebug.client_port=9003 —— 必须与 IDE 中监听端口一致；若被占用可改 9004，但两端要同步
xdebug.log=/tmp/xdebug.log —— 强烈建议开启，出问题时直接查日志比反复试配置高效得多
xdebug.discover_client_host=0 —— 关闭自动发现，避免因 DNS 或路由导致 client_host 错误

保存后，重启 PHP 服务（如 sudo systemctl restart php8.2-fpm 或 Apache/Nginx）。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

VS Code 端配置 launch.json

确保已安装官方扩展：PHP Debug（Felix Becker）。在项目根目录创建 .vscode/launch.json：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Listen for Xdebug",
      "type": "php",
      "request": "launch",
      "port": 9003,
      "pathMappings": {
        "/var/www/html/": "${workspaceFolder}/"
      }
    }
  ]
}

port 必须与 xdebug.client_port 完全一致
pathMappings 是远程路径 ↔ 本地路径的映射，必须精确匹配：
左侧为服务器上 PHP 实际运行的绝对路径（如 /var/www/html/），右侧为本地打开的项目路径（${workspaceFolder}/）
若项目部署在子目录（如 /var/www/html/api/），映射应写成 "/var/www/html/api/": "${workspaceFolder}/"