centos下php如何调试

在 CentOS 下进行 PHP 调试，Xdebug 几乎是绕不开的利器。下面把安装和配置的完整流程拆开来讲，每一步都配上实际命令，跟着走基本不会翻车。

1. 安装 EPEL 和 Remi 存储库

系统得先有这两个扩展源，不然很多包会找不到。先更新一下系统，然后装上 EPEL 和 Remi 仓库：

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

注意：如果你用的是 CentOS 8 或更高版本，remi-release 的包名可能要调整，换成对应版本号。

2. 安装 Xdebug

启用 Remi 仓库里对应 PHP 版本的模块，然后装 xdebug。以 PHP 7.4 为例：

sudo yum-config-manager --enable remi-php74
sudo yum install php-xdebug

这里的关键是——php74 要替换成你实际使用的 PHP 版本号，比如常见的 remi-php80、remi-php81 等等。装完之后可以用 php -v 确认一下 Xdebug 是否加载成功。

3. 配置 Xdebug

装好之后需要修改 php.ini 或者单独在 /etc/php.d/ 目录下放一个配置文件。推荐在 /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

这几行配置的意思是：开启调试模式，监听本地 9003 端口（PhpStorm 等 IDE 默认也是这个端口），并且每次请求都自动启动调试。如果你的 IDE 用了其他端口，比如 9000，记得改一下 client_port。

4. 重启 Web 服务器

配置生效需要重启服务。Apache 用户：

sudo systemctl restart httpd

Nginx + PHP-FPM 用户：

sudo systemctl restart nginx
sudo systemctl restart php-fpm

重启后可以写一个 phpinfo() 页面，搜索 Xdebug 看看是否已经加载，以及配置参数是否生效。

5. 配置 IDE（以 PhpStorm 为例）

打开 PhpStorm，进入 File → Settings → Languages & Frameworks → PHP，在 Debug 部分设置 Xdebug 的路径（比如 /usr/lib64/php/modules/xdebug.so），并确保 IDE key 和 Xdebug 的配置一致。默认情况下 Xdebug 的 IDE key 是 PHPSTORM，PhpStorm 自动匹配，基本不用改。

完成以上步骤，你就可以在代码里打上断点，用 PhpStorm 的调试按钮（小虫子图标）开始愉快的调试之旅了。变量值、调用栈、单步执行，一个都不少。