centos下phpstorm如何调试

在 CentOS 下使用 PhpStorm 调试 PHP，通常是通过 Xdebug 来实现的。下面一步一步说明，从环境准备到 PhpStorm 配置。

一、确认 PHP 环境

先确认 PHP 已安装：

php -v

查看 PHP 版本和安装方式（yum / remi / 编译）。

二、安装 Xdebug（CentOS）

1️⃣ 使用 yum（最常见）

如果是 PHP 7.x / 8.x（以 PHP 7.4 为例）：

sudo yum install php-xdebug

或（Remi 源）：

sudo yum install php74-php-xdebug

安装完成后检查：

php -m | grep xdebug

2️⃣ 如果没找到包（手动安装）

pecl install xdebug

然后确认 php.ini 中已加载。

三、配置 Xdebug（php.ini）

找到 php.ini：

php --ini

在末尾添加（示例，PHP 7.4 / Xdebug 2）：

[xdebug]
zend_extension=xdebug.so
xdebug.mode=debug
xdebug.remote_enable=1
xdebug.remote_host=127.0.0.1
xdebug.remote_port=9003
xdebug.idekey=PHPSTORM

✅ Xdebug 3 推荐配置（PHP 8）：

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

重启服务：

sudo systemctl restart php-fpm
sudo systemctl restart httpd   # 或 nginx

四、PhpStorm 配置

1️⃣ 配置 PHP 解释器

File → Settings → PHP
CLI Interpreter → 添加
选择 CentOS 上的 php 路径（如 /usr/bin/php）

2️⃣ 配置 Debug 端口

Settings → PHP → Debug
Debug port：9003
勾选 Can accept external connections

3️⃣ 配置 Server

Settings → PHP → Servers
新增：
- Name：centos
- Host：localhost
- Port：80
- Debugger：Xdebug
勾选 Use path mappings
映射：
- 本地项目路径 ↔ CentOS 项目路径

五、浏览器 / 请求调试

方式一：浏览器插件（推荐）

安装：

Chrome：Xdebug Helper

设置 IDE Key 为 PHPSTORM

点击图标 → Debug

方式二：手动触发

URL 加参数：

?XDEBUG_SESSION_START=PHPSTORM

六、PhpStorm 开始调试

在代码中打断点
点击 Run → Start Listening for PHP Debug Connections
浏览器访问页面
PhpStorm 会弹出调试窗口

七、常见问题

❌ 无法连接

防火墙：

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

❌ 路径不对

必须配置 Path Mappings

❌ 断点不生效

确认 Xdebug 已加载
确认 xdebug.mode=debug

八、总结一句话

CentOS + PhpStorm 调试 = 安装 Xdebug + 配置 php.ini + PhpStorm 映射路径 + 监听 9003

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

CentOS 版本
PHP 版本
用 Nginx 还是 Apache
本地还是远程调试

我可以给你 完全对应的配置示例。