当前位置：首页 > 文章列表 > 文章 > php教程 > PhpStorm远程调试设置全攻略

PhpStorm远程调试设置全攻略

2025-07-03 08:15:08 0浏览收藏

golang学习网今天将给大家带来《PhpStorm远程调试配置详解》，感兴趣的朋友请继续看下去吧！以下内容将会涉及到等等知识点，如果你是正在学习文章或者已经是大佬级别了，都非常欢迎也希望大家都能给我建议评论哈~希望能帮助到大家！

远程开发和调试在 PhpStorm 中可通过配置服务器连接、设置映射关系和启用 Xdebug 实现。1. 添加远程服务器：进入 Settings > Deployment > Configuration，选择 SFTP 类型，填写 Host、Port（通常为 22）、Root path、User name 和 Password，并测试连接；2. 设置映射关系：在 Mappings 标签中指定 Web server root URL、Deployment path 和 Local path，确保文件自动上传和路径正确识别；3. 启用远程调试：在服务器端配置 Xdebug 参数，重启服务后，在 PhpStorm 中点击电话图标开启监听，通过浏览器附加调试参数实现断点调试，使用 F7/F8/F9 控制执行流程。

PhpStorm的远程开发和调试功能的配置

远程开发和调试是 PhpStorm 中非常实用的功能，尤其对于需要在服务器端运行代码、本地调试的开发者来说。配置好后，你可以像操作本地项目一样编辑、调试远程服务器上的代码，效率提升明显。

配置远程服务器连接

首先要做的就是把你的远程服务器添加到 PhpStorm 里。这个步骤其实很简单，重点是填对主机地址、端口和登录凭据。

进入 Settings > Deployment > Configuration，点击加号添加新服务器。类型选 SFTP 就行了，然后填写：

Host：服务器 IP 或域名
Port：通常是 22，如果不是标准 SSH 端口要改过来
Root path：远程项目的根目录路径（绝对路径）
User name 和 Password：SSH 登录账号密码，也可以用密钥方式

设置好了之后点 Test Connection 测试一下，没问题就可以保存了。

设置映射关系（Mapping）

这一步很多人容易忽略，但它是实现自动上传、正确跳转断点的关键。

还是在 Deployment 的设置页，切换到 Mappings 标签。这里需要设置三项：

Web server root URL：如果你有浏览器访问地址，可以填上，方便预览页面
Deployment path：部署路径，也就是你上面填的 root path 下的具体子目录（比如 /var/www/html/project）
Local path：本地项目的对应路径，这样 PhpStorm 才知道哪些文件应该传到哪里

这个映射设置准确了，你每次保存文件才会自动上传，调试时也能正确识别路径。

启用远程调试（Xdebug 配置）

调试部分稍微复杂一点，主要是要配好 Xdebug，而且两边（服务器和 PhpStorm）得能通。

先确保远程服务器 PHP 已安装并启用了 Xdebug。可以在 php.ini 或 conf.d 文件中加入以下配置（根据实际情况调整）：

zend_extension=xdebug.so
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=你的本机IP（或内网IP）
xdebug.client_port=9003

重启 PHP-FPM 或 Apache 生效。

接下来在 PhpStorm 里开启监听：

点击右上角的电话图标（Start Listening for PHP Debug Connections），变成绿色就说明开始监听了
在浏览器访问你想调试的页面，加上 XDEBUG_SESSION_START=PHPSTORM 参数，例如：http://your-site.com/page?XDEBUG_SESSION_START=PHPSTORM
这时候 PhpStorm 应该会弹出一个调试窗口，表示已经连上了