首先安装并启用Xdebug扩展，通过包管理器或手动编译方式安装，并在php.ini中添加zend_extension配置；接着配置Xdebug调试参数，设置xdebug.mode=debug、client_host和client_port=9003，确保与IDE端口一致；然后在PhpStorm等IDE中设置PHP Debug环境，配置服务器路径映射并启动监听；最后在代码中设置断点，通过URL附加?XDEBUG_TRIGGER=1触发调试会话，IDE将接收连接并暂停执行以检查变量和堆栈。
如果您在开发PHP应用时需要逐行检查代码执行流程，定位变量值变化或函数调用问题，使用调试工具可以显著提升排查效率。Xdebug 是 PHP 最常用的调试扩展之一，配合支持调试协议的编辑器可实现断点调试、堆栈追踪和性能分析。以下是配置与使用 Xdebug 进行断点调试的具体步骤：
一、安装并启用Xdebug扩展
该步骤的目的是在PHP环境中加载Xdebug扩展，使其能够与调试客户端通信。Xdebug作为Zend扩展运行，必须正确编译或通过包管理器安装。
1、通过包管理器安装Xdebug，例如在Ubuntu系统中执行：sudo apt install php-xdebug。
2、若使用手动编译方式，下载对应版本的Xdebug源码，进入目录后执行：phpize && ./configure && make && sudo make install。
立即学习“PHP免费学习笔记（深入）”；
3、打开php.ini文件，在末尾添加以下配置以启用Xdebug：
zend_extension=xdebug.so（Linux/macOS）
zend_extension=xdebug.dll（Windows）
4、保存文件后重启Web服务器或PHP-FPM服务使更改生效。
二、配置Xdebug调试参数
为了建立调试会话，需设置Xdebug的工作模式为远程调试，并指定客户端监听地址和端口。这些参数控制调试连接的建立方式。
1、在php.ini中Xdebug段落添加以下关键配置：
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
2、确保client_port与IDE监听端口一致，默认为9003，避免被防火墙拦截。
3、可通过设置xdebug.log=/tmp/xdebug.log记录调试日志，便于排查连接失败问题。
三、在IDE中配置调试环境
集成开发环境需启动内置调试监听器，并识别项目根目录以便映射断点位置。主流IDE均支持Xdebug协议。
1、在PhpStorm中打开Settings > Languages & Frameworks > PHP > Debug，确认Xdebug端口为9003。
2、进入Servers设置，绑定项目路径与访问URL，勾选“Use path mappings”并设置远程与本地路径对应关系。
3、点击工具栏上的电话图标启用“Listen for PHP Debug Connections”，进入等待连接状态。
4、其他支持Xdebug的编辑器如VS Code需安装PHP Debug扩展，并在launch.json中配置相应字段。
四、启动调试会话并设置断点
调试会话通过特定触发机制激活Xdebug向客户端发起连接。设置断点可暂停执行以便检查上下文状态。
1、在代码编辑器中打开目标PHP文件，点击行号旁空白区域设置断点，标记将显示为红点。
2、通过浏览器访问目标脚本URL，并附加调试标识符，例如：http://localhost/script.php?XDEBUG_TRIGGER=1。
3、当请求到达时，Xdebug检测到触发条件，自动连接至IDE并暂停在首个断点处。
4、此时可在IDE中查看变量值、调用堆栈及当前作用域信息，使用步进按钮逐行执行代码。
