centos如何用phpstorm调试

在 CentOS 上使用 PhpStorm 调试 PHP，通常是通过 Xdebug 实现的。下面我按“从零开始”的流程给你讲清楚。

一、环境准备

假设你的情况是：

• 系统：CentOS 7 / 8
• Web 服务：Nginx 或 Apache
• PHP 运行方式：PHP-FPM
• 开发机：Windows / macOS（运行 PhpStorm）

二、在 CentOS 上安装 Xdebug

1. 查看 PHP 版本

php -v

2. 安装 Xdebug（以 PHP 7.4 为例）

yum install php-pear php-devel gcc
pecl install xdebug

安装完成后会看到类似：

/usr/lib64/php/modules/xdebug.so

三、配置 php.ini

1. 找到 php.ini

php --ini

2. 编辑 php.ini（或新建 xdebug.ini）

vi /etc/php.d/xdebug.ini

写入以下内容（重点）：

zend_extension=/usr/lib64/php/modules/xdebug.so

[Xdebug]
xdebug.mode=debug
xdebug.start_with_request=trigger
xdebug.client_host=192.168.1.100   ; 你的开发机 IP
xdebug.client_port=9003
xdebug.idekey=PHPSTORM

⚠️ client_host 是 你本地电脑的 IP，不是 CentOS 的 IP

3. 重启 PHP

systemctl restart php-fpm
# 或
systemctl restart httpd

4. 验证

php -m | grep xdebug

能看到 xdebug 说明成功。

四、配置 PhpStorm

1. 设置 PHP 解释器

Settings → PHP → CLI Interpreter

• 如果用远程服务器：
  • 选择 Remote Interpreter（SSH）
  • 填 CentOS 的 IP / 用户名 / 密码

2. 配置 Debug

Settings → PHP → Debug

• Debug Port：9003
• 勾选 Can accept external connections

3. 配置 Servers

Settings → PHP → Servers

• Name：随意（如 centos-server）
• Host：CentOS IP
• Port：80 / 443
• Debugger：Xdebug
• ✅ Use path mappings
  • 本地项目路径 ↔ 服务器项目路径

例如：

本地：D:/project
远程：/var/www/html/project

五、启动调试

方式一：浏览器触发（推荐）

1. 在 PhpStorm 点 电话图标（Listen for Debug）
2. 浏览器安装插件：
   • Chrome：Xdebug Helper
3. 设置 IDE Key = PHPSTORM
4. 打开网页，点“Debug”

方式二：手动触发

URL 后加：

?XDEBUG_SESSION=PHPSTORM

六、常见问题

1. 断点不生效

• 检查 path mapping 是否正确
• 查看 PhpStorm 是否处于 Listen 状态
• 查看防火墙：

firewall-cmd --add-port=9003/tcp --permanent
firewall-cmd --reload

2. 连不上

• CentOS 能 ping 通你的电脑
• 电脑防火墙允许 9003

3. CLI 调试

export XDEBUG_SESSION=PHPSTORM
php script.php

七、总结流程图

CentOS(PHP+Xdebug)  ←→  PhpStorm(本地)
        ↑
   浏览器触发

如果你愿意，可以告诉我：

• CentOS 版本
• PHP 版本
• 用的是 Apache 还是 Nginx
• 本地系统是 Windows 还是 Mac

我可以给你一份 完全对应你环境的配置示例。