首先确认PHP环境并安装Xdebug扩展，可通过apt安装或源码编译；然后在php.ini中添加zend_extension并配置调试参数xdebug.mode、client_host等；最后通过phpinfo()或php -m验证是否启用成功。
如果您在开发PHP应用时需要进行代码调试，但缺乏有效的调试工具，则可能会导致排查问题效率低下。Xdebug是一个强大的PHP扩展，能够提供详细的错误信息、堆栈跟踪和远程调试功能。以下是安装与配置Xdebug的完整流程。
本文运行环境：Dell XPS 13，Ubuntu 24.04
一、确认PHP环境并安装Xdebug扩展
在开始之前，必须确保系统中已正确安装PHP，并能通过命令行访问phpize和php-config工具。使用包管理器安装Xdebug是最简单的方式，尤其适用于主流Linux发行版。
1、打开终端，执行 php -v 检查当前PHP版本信息。
立即学习“PHP免费学习笔记（深入）”；
2、运行 sudo apt search php-xdebug 查找适用于您PHP版本的Xdebug包。
3、根据输出结果，安装对应版本，例如执行 sudo apt install php8.3-xdebug。
二、手动编译安装Xdebug（适用于自定义环境）
当系统包管理器未提供合适版本时，可从源码编译Xdebug。此方法灵活性高，适合定制化PHP环境或特定需求场景。
1、访问 https://xdebug.org/download 下载对应版本的Xdebug源码压缩包。
2、解压文件后进入目录，执行 phpize 初始化扩展构建环境。
3、运行 ./configure --enable-xdebug 配置编译参数。
4、依次执行 make && sudo make install 完成编译与安装。
三、配置php.ini启用Xdebug
Xdebug安装完成后，需修改PHP配置文件以加载扩展并设置调试参数。该步骤决定了Xdebug是否生效及其行为模式。
1、查找php.ini位置，可通过 php --ini | grep "Loaded Configuration File" 获取路径。
2、编辑php.ini文件，在末尾添加：
zend_extension=xdebug.so
若为绝对路径，则写为 zend_extension=/usr/lib/php/20230831/xdebug.so。
3、保存文件并退出编辑器。
四、设置Xdebug调试参数
为了启用远程调试功能并与IDE协同工作，需要在php.ini中配置Xdebug的工作模式及相关网络参数。
1、在php.ini中追加以下内容：
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
2、如使用其他IDE或监听端口不同，需调整client_port值以匹配实际设置。
五、验证Xdebug是否成功启用
完成配置后，必须验证Xdebug是否被PHP正确加载。这一步可以避免因配置错误导致调试功能无法使用。
1、创建一个PHP文件，写入 并通过Web服务器访问。
2、在页面搜索“xdebug”，若出现Xdebug相关信息区块，则表示扩展已启用。
3、也可在终端执行 php -m | grep xdebug，若返回xdebug则说明模块加载成功。
