在CentOS上调试PHP，常见做法是通过Xdebug搭建调试环境。 下面按步骤说明整个配置过程，方便你直接照着操作。

开始前的准备：安装EPEL和Remi存储库

先确认系统中已经安装EPEL和Remi这两个存储库。Xdebug通常需要通过它们来获取。

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

执行完成后，仓库就准备好了。

启用Remi存储库，并指定PHP版本

接下来启用Remi仓库，并选择与你当前环境对应的PHP版本。

• PHP 7.4 使用 remi-php74
• PHP 8.0 使用 remi-php80

例如：

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

这一步很关键。 如果版本选错，后续安装或运行时可能会报错。

安装Xdebug扩展

仓库启用后，就可以安装Xdebug扩展了。

sudo yum install php-xdebug

等待安装完成即可。

核心配置：修改php.ini

安装完成后，还需要进行配置。打开php.ini文件，通常位于/etc/php.ini或/etc/php.d/目录下。

在文件末尾追加以下内容：

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

配置项说明

• 加载Xdebug扩展
• 开启调试模式
• 指定IDE监听地址和端口（默认9003）
• 让每次请求都自动触发调试

如果IDE不在本机，可将client_host改为对应IP。

重启Web服务器，让配置生效

修改配置后，必须重启Web服务器，否则配置不会生效。

如果用的是Apache

sudo systemctl restart httpd

如果用的是Nginx + PHP-FPM

sudo systemctl restart nginx
sudo systemctl restart php-fpm

这一步不要遗漏。 否则前面的配置等于没有生效。

IDE那边的配置

最后，在IDE中设置服务器映射。以PhpStorm为例，打开File → Settings → Languages & Frameworks → PHP → Servers。

添加一个服务器，名称可自定义，例如“Local”。主机名填写localhost，并勾选“Use path mappings”，把服务器路径映射到本地项目目录。

完成后的调试方式

配置完成后，就可以在IDE中设置断点，再通过浏览器访问你的PHP应用。

Xdebug会在断点处暂停。 这样你就可以逐步跟踪代码、查看变量值，更直观地排查问题。