centosphpstorm调试怎么设

下面按CentOS + PHP + PhpStorm最常见场景（PHP-FPM / Web 调试）给你一套清晰步骤。如果你用的是 CLI 调试或 Docker，我也可以再补。

一、环境准备（CentOS 上）

1. 安装 PHP 与 Xdebug

# 查看 PHP 版本
php -v

# 安装对应版本的 php-devel 和 pecl
yum install php-devel php-pear gcc make

# 安装 Xdebug
pecl install xdebug

安装完成后会看到类似：

You should add "zend_extension=/usr/lib64/php/modules/xdebug.so" to php.ini

2. 配置 php.ini

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

php --ini

新建或编辑：

[xdebug]
zend_extension=/usr/lib64/php/modules/xdebug.so
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=192.168.x.x   # 你的 Windows / Mac IP
xdebug.client_port=9003
xdebug.idekey=PHPSTORM

⚠️ CentOS 如果是 PHP 7.2+，用 xdebug.mode
老版本用 xdebug.remote_enable=1

重启 PHP-FPM：

systemctl restart php-fpm

二、PhpStorm 设置

1. 配置 PHP 解释器

Settings → PHP → CLI Interpreter
→ + → From Docker / Remote / Local

如果是远程 CentOS：

用 SSH Interpreter
填 CentOS IP、用户、PHP 路径

2. Debug 端口

Settings → PHP → Debug
→ Debug port: 9003

3. 配置 Server

Settings → PHP → Servers
→ + 
Name: centos
Host: 项目域名或IP
Port: 80
Debugger: Xdebug
✔ Use path mappings
   /local/path  ↔  /remote/path

三、浏览器调试（Web）

方法一：浏览器插件

安装 Xdebug Helper
设为 Debug
访问页面即可断点

方法二：URL 参数

http://centos/test.php?XDEBUG_SESSION=PHPSTORM

四、PhpStorm 启动调试

打断点
点 电话图标（Start Listening）
浏览器访问页面
PhpStorm 会弹窗 → 接受

五、CLI 调试（命令行）

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

六、常见问题

❌ 连不上
✅ 防火墙：

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

❌ path mapping 错
✅ 本地和远程路径必须一一对应

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

CentOS 版本
PHP 版本
本地 Windows / Mac 还是远程开发

我可以直接给你专属配置示例。