centos如何调试phpstorm

在 CentOS 上调试 PHPStorm（通常指用 Xdebug 远程/本地调试 PHP 代码），常见做法如下。下面以 PHP + Xdebug + PHPStorm 为例，适用于 CentOS 7 / 8 / Stream。

一、在 CentOS 上安装 Xdebug

1. 安装 PHP 及开发包

yum install php php-cli php-devel -y

（CentOS 8 用 dnf）

2. 安装 Xdebug

pecl install xdebug

如果提示没有 pecl：

yum install php-pear -y

3. 确认 Xdebug 已加载

php -m | grep xdebug

二、配置 php.ini（Xdebug）

找到 php.ini（通常 /etc/php.ini 或 /etc/php.d/）

vi /etc/php.d/xdebug.ini

示例配置（Xdebug 3）：

zend_extension=xdebug.so

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

如果是 远程调试（PHPStorm 在 Windows/Mac）：

xdebug.client_host=你的电脑IP
xdebug.discover_client_host=0

重启 PHP：

systemctl restart php-fpm
# 或
systemctl restart httpd

三、配置 PHPStorm

1. 设置 PHP 解释器

File → Settings → PHP
CLI Interpreter → +
选择 Remote / SSH Interpreter（CentOS IP）
或 Local（如果 PHPStorm 在 CentOS 上）

2. 配置 Debug 端口

PHP → Debug
Debug port: 9003

3. 配置 Server

PHP → Servers
添加：
- Name: centos
- Host: CentOS IP
- Port: 80
- Debugger: Xdebug
- 勾选 Use path mappings
- 本地路径 ↔ CentOS 路径

四、启动调试

方式一：浏览器（推荐）

安装浏览器插件
- Chrome：Xdebug Helper
启用 Debug
PHPStorm 点 Listen for Debug Connections
访问页面 → 断点生效

方式二：PHPStorm 直接 Run/Debug

右上角 → Edit Configurations
选择 PHP Web Page / PHP Script
设置入口文件
点击 Debug ▶

五、常见问题

1. 断点不生效

检查 php -m 是否有 xdebug
检查端口是否被占用
检查 path mapping 是否正确

2. 防火墙

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

3. SELinux

setsebool -P httpd_can_network_connect 1

六、验证 Xdebug

php -i | grep xdebug

如果你说的是 调试 PHPStorm 本身（Java） 或 在 CentOS 上用 PHPStorm GUI，可以告诉我具体场景，我可以给你更精确的方案。