在 CentOS 上调试 PHP 代码，您可以使用 Xdebug 扩展

Xdebug 是 PHP 开发者进行代码调试和性能分析的强大工具，它能有效实现断点调试、堆栈跟踪和性能监控等核心功能。本指南将详细介绍如何在 CentOS 系统中安装与配置 Xdebug，帮助您搭建高效的 PHP 调试环境。

1. 安装 EPEL 和 Remi 存储库

首先，您需要在 CentOS 系统中添加 EPEL（Extra Packages for Enterprise Linux）和 Remi 软件仓库，这两个源提供了最新且稳定的 Xdebug 扩展包。

sudo yum install epel-release
sudo yum install https://rpms.remirepo.net/enterprise/remi-release-7.rpm

2. 启用 Remi 存储库

接下来，启用 Remi 存储库以访问其中的 PHP 扩展。执行以下命令启用对应版本的仓库：

sudo yum-config-manager --enable remi-php74

请注意：命令中的 remi-php74 需根据您服务器实际安装的 PHP 版本进行替换。例如，若使用 PHP 8.0，则应修改为 remi-php80。

3. 安装 Xdebug

完成仓库配置后，即可通过 Yum 包管理器轻松安装 Xdebug 扩展。

sudo yum install php-xdebug

4. 配置 Xdebug

安装后需对 Xdebug 进行正确配置。编辑 PHP 配置文件（通常为 /etc/php.ini 或 /etc/php.d/xdebug.ini），并添加以下配置参数：

zend_extension=xdebug.so
xdebug.mode=debug
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
xdebug.start_with_request=yes

这些配置启用了 Xdebug 调试模式，并设置其通过 9003 端口与 IDE 通信。请确保 xdebug.client_host 和 xdebug.client_port 与您本地开发环境中的调试设置相匹配。

5. 重启 Web 服务器

修改配置后，必须重启 Web 服务使更改生效。

若使用 Apache 服务器：

sudo systemctl restart httpd

若使用 Nginx 并搭配 PHP-FPM：

sudo systemctl restart nginx
sudo systemctl restart php-fpm

6. 使用 PhpStorm 进行调试

服务端配置完成后，即可在 PhpStorm 中设置远程调试。首先，进入 “File” > “Settings” > “Languages & Frameworks” > “PHP”，指定 Xdebug 扩展路径（如 /usr/lib64/php/modules/xdebug.so）。随后，通过 “Tools” > “Deployment” 配置服务器连接。

在 PhpStorm 中打开项目，在代码行号旁单击设置断点。接着，点击 “Run” > “Start Listening for PHP Debug Connections” 启动调试监听。此时，通过浏览器访问您的应用，Xdebug 将自动触发断点，您可以在 PhpStorm 中实时查看变量内容、执行流程和调用堆栈，实现可视化调试。

遵循以上步骤，您便成功在 CentOS 上配置了 Xdebug 调试环境。这套方案能显著提升 PHP 代码调试效率，助力开发工作更加流畅。