centos phpstorm怎么调试

在 CentOS 上用 PhpStorm 调试 PHP，一般是通过 Xdebug 来实现。下面给你一套常见、可用的完整流程（以 PHP 7.x / 8.x + Xdebug 3 为例）。

一、在 CentOS 上安装 Xdebug

1. 确认 PHP 版本

php -v

2. 安装 Xdebug

如果你是 PHP 通过 yum/remi 安装：

sudo yum install php-xdebug

如果是编译安装 PHP，用 pecl：

pecl install xdebug

安装完成后确认：

php -m | grep xdebug

二、配置 Xdebug（php.ini）

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

Xdebug 3 示例配置

[xdebug]
zend_extension=xdebug.so
xdebug.mode=debug
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
xdebug.idekey=PHPSTORM

⚠️ 如果你用的是 Xdebug 2，配置是：

xdebug.remote_enable=1
xdebug.remote_host=127.0.0.1
xdebug.remote_port=9000
xdebug.idekey=PHPSTORM

重启 PHP：

systemctl restart php-fpm
# 或
systemctl restart httpd

三、PhpStorm 配置

1. 设置 PHP 解释器

• File → Settings → PHP
• CLI Interpreter → 选择 CentOS 上的 PHP
• 确认 Xdebug 已显示 ✅

2. 配置 Debug 端口

• Settings → PHP → Debug
• Debug port: 9003（Xdebug3）
• 勾选 Can accept external connections

3. 配置 Servers

• Settings → PHP → Servers
• 新增：
  • Name: centos
  • Host: localhost 或你的域名
  • Port: 80
  • Debugger: Xdebug
• 勾选 Use path mappings
  • 本地路径 ↔ CentOS 项目路径

四、启动调试

方式一：浏览器 + Bookmark（推荐）

1. 在浏览器安装 Xdebug Helper
2. 设置为 Debug
3. 在 PhpStorm 点击 电话图标（Listen）
4. 访问页面 → 自动断点

方式二：PHP CLI 调试

export XDEBUG_MODE=debug
export XDEBUG_CONFIG="idekey=PHPSTORM"
php your_script.php

五、常见问题

连不上？

• 防火墙：

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

• 云服务器：安全组放行 9003
• 确认 PhpStorm 电话图标是亮的

路径不对？

• 一定要配置 Path Mappings
• 本地 ≠ CentOS 路径

六、快速检查命令

php -i | grep xdebug

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

• PHP 版本
• Xdebug 版本
• 是 Web 还是 CLI
• 本地 Windows / Mac 还是直接 CentOS 桌面

我可以给你 更精确的配置。