PHP 调试工具怎么用_PHP Xdebug远程调试配置与断点追踪技巧【追踪】-php教程-PHP中文网

断点不命中主因是xdebug未连上ide，需正确配置xdebug.mode=debug、xdebug.start_with_request=trigger、xdebug.client_host及client_port=9003，并确保浏览器带xdebug_session_start参数、ide真监听且路径映射准确。

php 调试工具怎么用_php xdebug远程调试配置与断点追踪技巧【追踪】

断点不命中，八成不是代码问题，而是 Xdebug 没连上 IDE —— 它根本没发起连接，或者连了但被拒绝、超时、配错端口。

php.ini 里只留这三行才管用

Xdebug 3.x 彻底废弃了 xdebug.remote_* 系列配置，继续保留会直接报 Unknown configuration setting 错误。删掉所有带 remote_ 前缀的行（比如 xdebug.remote_host、xdebug.remote_port），只保留：

xdebug.mode=debug：必须是 debug，不是 develop 或 profile
xdebug.start_with_request=trigger：设为 trigger 更安全，避免每次请求都强制调试；设为 yes 虽省事，但可能干扰 CLI 脚本或健康检查接口
xdebug.client_host=127.0.0.1（本地直连）或 host.docker.internal（Docker 容器内访问宿主机）：别写 localhost，某些系统解析失败；Mac M1/M2 用户若用 Docker Desktop，需确认该 host 是否已启用

顺手加上 xdebug.client_port=9003（Xdebug 3 默认端口），确保和 IDE 设置一致；xdebug.log 路径也建议配上，出问题时第一眼就看它。

浏览器不带参数 = Xdebug 根本不启动

?XDEBUG_SESSION_START=PHPSTORM 不是可选动作，是触发开关。Xdebug 3 默认不自动连，不带这个参数，xdebug.start_with_request=trigger 就不会生效。

ApiPost接口调试与文档生成工具

ApiPost是一个支持团队协作，支持模拟POST、GET、PUT等常见请求，并可直接生成文档的API调试、管理工具，ApiPost是后台接口开发者或前端、接口测试人员的工作必备工具。快速生成、一键导出API文档。感兴趣的朋友快来下载吧。软件说明ApiPost官方版是一款十分出色的接口调试与文档生成工具，ApiPost官方版界面美观大方，功能强劲实用，支持团队协作，支持模拟POST、GET、PUT等常见请求，是后台接口开发者或前端、接口测试人员的工作必备工具。软件特色更方便支持接口调试的同时快速生成、一键

下载

手动拼 URL 最快：在地址栏末尾加 ?XDEBUG_SESSION_START=PHPSTORM（IDE key 必须匹配，PhpStorm 默认是 PHPSTORM，VS Code 是 VSCODE）
装官方 JetBrains IDE Helper 插件，点虫子图标一键激活，自动管理 cookie
别依赖 xdebug.idekey 配置来“默认匹配”——它只用于会话路由，不替代触发参数

如果用了 Nginx/Apache 反向代理，确认 query string 没被过滤（尤其 proxy_pass 后漏了 $args）。

IDE 监听没真开，断点永远是灰色

PhpStorm 工具栏那个小电话图标变绿 ≠ 真监听；VS Code 按下 Ctrl+Shift+D 切到运行视图后，必须点击绿色 ▶ 启动调试配置（不是直接按 F5），否则只是空转。

确认 Settings > PHP > Debug > Xdebug > Debug port 是 9003（不是旧版 9000）
Linux/macOS 执行 sudo lsof -i :9003，Windows 执行 netstat -ano | findstr :9003，看到 LISTEN 才算成功
防火墙/杀毒软件常静默拦截 9003，尤其是 Windows Defender；临时关闭测试一次，能连上就说明是它拦的
PHP-FPM 场景下，检查 php-fpm.conf 或 pool 配置里有没有 php_admin_value[xdebug.mode] = off 这类强制覆盖项

路径映射错一个字符，变量值就全为空

IDE 显示变量为空、堆栈显示文件路径为 file:///var/www/html/... 而非你本地路径？基本就是服务器路径和本地路径没对齐。

PhpStorm：Preferences > PHP > Servers → 添加服务器 → 勾选 “Use path mappings”，左边填服务器绝对路径（如 /var/www/project），右边填你本地项目根目录（如 /Users/me/project）
VS Code：launch.json 中 pathMappings 必须严格对应，注意结尾斜杠（/var/www/project/ vs /var/www/project）
Docker 环境下，容器内路径是 /app，但你本地挂载的是 ./src，映射必须反映这一层关系