在进行 PHP 开发时，代码调试几乎是日常工作的重要环节。在 CentOS 系统上配置 Xdebug 环境并不复杂，只需掌握几个关键步骤，即可快速搭建稳定的调试环境。下面将详细介绍配置流程，帮助你轻松上手。
- 安装 EPEL 和 Remi 软件源
首先需要确保系统已经添加了 EPEL 和 Remi 这两个软件源。如果没有安装，直接执行以下命令即可：
sudo yum install epel-releasesudo yum install https://rpms.remirepo.net/enterprise/remi-release-7.rpm- 安装 Xdebug 扩展
接下来，启用 Remi 软件源中对应的 Xdebug 模块，然后执行安装命令。具体操作如下：
sudo yum-config-manager --enable remi-php74sudo yum install php-xdebug需要注意：上述命令以 PHP 7.4 版本为例。如果你使用的是其他 PHP 版本（例如 PHP 7.3），请将 php74 替换为 php73，避免版本不匹配导致安装失败。
- 配置 Xdebug 参数
编辑 PHP 配置文件 php.ini（通常位于 /etc/php.ini 或 /etc/php.d/ 目录下），在文件末尾添加如下配置项：
zend_extension=xdebug.soxdebug.mode=debugxdebug.client_host=127.0.0.1xdebug.client_port=9003xdebug.idekey=PHPSTORM上述配置开启了调试模式，并指定了客户端地址与端口。其中 idekey 是 Xdebug 与 IDE（如 PhpStorm）之间的通信标识，务必保持一致，否则调试连接可能无法建立。
- 重启 Web 服务器
配置完成后，需要重启 Web 服务器才能使设置生效。请根据你使用的服务器类型选择对应命令：
Apache 服务器：
sudo systemctl restart httpdNginx 服务器：
sudo systemctl restart nginx- 配置 PhpStorm 开发环境
打开 PhpStorm，依次进入 File → Settings → Languages & Frameworks → PHP。在 CLI Interpreter 部分选择正确的 PHP 解释器版本。然后进入 Settings → Languages & Frameworks → PHP → Servers，添加一个新的服务器配置，填写以下信息：
- Name: 自定义名称，例如 “Local”
- Host: localhost
- Port: 80（或服务器实际使用的端口）
- Debugger: Xdebug
点击 “OK” 保存配置即可。
- 设置断点并启动调试
在代码中设置断点，然后在 PhpStorm 中点击 Run → Start Listening for PHP Debug Connections，启动监听。接着访问你的 PHP 应用，Xdebug 会在断点处自动暂停，此时你可以自由查看变量值、堆栈跟踪等信息，调试过程非常高效便捷。
如需深入了解更高级的调试技巧，建议查阅 Xdebug 和 PhpStorm 的官方文档，其中提供了丰富的进阶用法：
- Xdebug 官方文档：https://xdebug.org/docs/2.9
- PhpStorm 调试指南：https://www.jetbrains.com/help/phpstorm/debugging-your-application.html
