PHPStorm 使用 Xdebug 远程调试配置指南 (CentOS7 + 宝塔面板)<\/h1>

一、环境准备<\/h2>

1. 系统安装<\/h3>

安装纯净版 CentOS 7.9 系统<\/li>

确保系统基础环境配置完成（网络、防火墙等）<\/li> <\/ul>

2. 宝塔面板安装<\/h3>

执行以下命令安装最新稳定版宝塔面板：<\/p>

yum install -y wget &&<\/span> wget -O install.sh http:\/\/download.bt.cn\/install\/install_6.0.sh &&<\/span> sh install.sh
<\/span><\/span><\/code><\/pre>3. 环境组件安装<\/h3>
通过宝塔面板安装以下组件：<\/p>

LNMP 架构（默认配置）<\/li>
PHP 7.4 版本<\/li>
<\/ul>
二、Xdebug 扩展配置<\/h2>
1. 安装 Xdebug 扩展<\/h3>
通过宝塔面板的 PHP 管理界面安装 Xdebug 扩展<\/p>
2. 配置 Xdebug<\/h3>
在 PHP 配置文件（php.ini）中添加以下配置：<\/p>
[xdebug]<\/span>
<\/span><\/span>zend_extension<\/span>=<\/span>xdebug.so<\/span>
<\/span><\/span>xdebug.mode<\/span>=<\/span>debug<\/span>
<\/span><\/span>xdebug.discover_client_host<\/span>=<\/span>true<\/span>
<\/span><\/span>xdebug.remote_cookie_expire_time<\/span>=<\/span>3600<\/span>
<\/span><\/span>xdebug.client_port<\/span>=<\/span>9003<\/span>
<\/span><\/span>xdebug.client_host<\/span>=<\/span>"192.168.158.1" ; 改为你的本地开发机IP<\/span>
<\/span><\/span>xdebug.start_with_request<\/span>=<\/span>yes<\/span>
<\/span><\/span>xdebug.remote_handler<\/span>=<\/span>"dbgp"<\/span>
<\/span><\/span>xdebug.log<\/span>=<\/span>\/tmp\/xdebug.log<\/span>
<\/span><\/span><\/code><\/pre>3. 重启服务<\/h3>
配置完成后必须重启相关服务：<\/p>
service php-fpm restart
<\/span><\/span>service nginx restart
<\/span><\/span><\/code><\/pre>三、网站环境搭建<\/h2>

通过宝塔面板创建网站<\/li>
上传项目代码到网站目录<\/li>
创建并配置数据库<\/li>
确保网站可以正常访问<\/li>
<\/ol>
四、PHPStorm 配置<\/h2>
1. PHP 设置<\/h3>

进入 File > Settings > PHP<\/code><\/li>
配置 PHP 解释器路径<\/li>
设置 PHP 语言级别为 7.4<\/li>
<\/ul>
2. DBGp 代理设置<\/h3>

进入 File > Settings > PHP > Debug > DBGp Proxy<\/code><\/li>
配置 IDE key（与浏览器插件一致）<\/li>
设置 Host 为你的服务器IP<\/li>
Port 设置为 9003（与 xdebug.client_port 一致）<\/li>
<\/ul>
3. 调试设置<\/h3>

进入 File > Settings > PHP > Debug<\/code><\/li>
配置调试端口为 9003<\/li>
勾选 "Break at first line in PHP scripts"<\/li>
<\/ul>
4. 部署与映射<\/h3>

进入 Tools > Deployment > Configuration<\/code><\/li>
添加服务器配置（SFTP 或 FTP）<\/li>
配置路径映射（本地路径与服务器路径对应）<\/li>
<\/ul>
5. SSH 配置<\/h3>

进入 Tools > SSH Configuration<\/code><\/li>
添加服务器SSH连接信息<\/li>
测试连接并保存<\/li>
<\/ul>
6. PHP CLI 解释器<\/h3>

进入 File > Settings > PHP > CLI Interpreter<\/code><\/li>
添加远程解释器<\/li>
配置与服务器相同的PHP版本<\/li>
<\/ul>
五、浏览器配置<\/h2>

安装 Xdebug Helper 插件（Chrome 浏览器）<\/li>
配置 IDE key（与 PHPStorm 中设置一致）<\/li>
在需要调试的页面上启用调试模式<\/li>
<\/ol>
六、调试流程<\/h2>

在 PHPStorm 中启动监听（电话图标）<\/li>
在浏览器中访问目标页面（确保插件已启用调试）<\/li>
设置断点并开始调试<\/li>
也可以直接使用 Burp Suite 等工具发包调试<\/li>
<\/ol>
七、常见问题解决<\/h2>


无法拦截调试请求<\/strong>：<\/p>

检查防火墙是否开放 9003 端口<\/li>
确认 xdebug.client_host 配置正确<\/li>
重启 PHP-FPM 和 Nginx 服务<\/li>
重启 PHPStorm<\/li>
<\/ul>
<\/li>

连接不稳定<\/strong>：<\/p>

检查网络连接<\/li>
增加 xdebug.remote_cookie_expire_time 值<\/li>
检查 \/tmp\/xdebug.log 日志文件<\/li>
<\/ul>
<\/li>

断点不生效<\/strong>：<\/p>

确认代码同步（本地与服务器代码一致）<\/li>
检查路径映射配置<\/li>
确认 PHPStorm 正在监听调试连接<\/li>
<\/ul>
<\/li>
<\/ol>
八、注意事项<\/h2>

生产环境不建议开启 Xdebug，仅限开发测试环境使用<\/li>
调试完成后建议关闭 Xdebug 或设置 xdebug.start_with_request=trigger<\/li>
保持 PHPStorm 和 Xdebug 版本兼容<\/li>
复杂的调试场景可以使用 xdebug.idekey 区分不同开发人员<\/li>
<\/ol>
通过以上完整配置，您应该能够在 PHPStorm 中成功进行远程 Xdebug 调试。如遇问题，建议按照配置步骤逐一检查，并查看 \/tmp\/xdebug.log 日志文件获取详细错误信息。<\/p>

PHPStorm 使用 Xdebug 远程调试配置指南 (CentOS7 + 宝塔面板)<\/h1>

一、环境准备<\/h2>

二、Xdebug 扩展配置<\/h2>

1. 安装 Xdebug 扩展<\/h3> 通过宝塔面板的 PHP 管理界面安装 Xdebug 扩展<\/p>

四、PHPStorm 配置<\/h2>

1. 安装 Xdebug 扩展<\/h3>
通过宝塔面板的 PHP 管理界面安装 Xdebug 扩展<\/p>