0

0

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

蓮花仙者

蓮花仙者

发布时间:2025-07-10 18:22:02

|

643人浏览过

|

来源于php中文网

原创

远程开发和调试在 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的远程开发和调试功能的配置

配置远程服务器连接

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

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

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

立即学习PHP免费学习笔记(深入)”;

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

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

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

设置映射关系(Mapping)

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

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

BJXSHOP网上购物系统 - 书店版
BJXSHOP网上购物系统 - 书店版

BJXSHOP购物管理系统是一个功能完善、展示信息丰富的电子商店销售平台;针对企业与个人的网上销售系统;开放式远程商店管理;完善的订单管理、销售统计、结算系统;强力搜索引擎支持;提供网上多种在线支付方式解决方案;强大的技术应用能力和网络安全系统 BJXSHOP网上购物系统 - 书店版,它具备其他通用购物系统不同的功能,有针对图书销售而进行开发的一个电子商店销售平台,如图书ISBN,图书目录

下载
  • 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 应该会弹出一个调试窗口,表示已经连上了

调试时的小技巧

  • 断点设置:在代码编辑器左边灰色区域点击就能加断点,执行到那里就会停下来
  • 变量查看:调试窗口里可以看到当前作用域里的变量值,鼠标悬停在变量上也能看到
  • 多步执行:F7 是步入,F8 是步过,F9 是继续执行直到下一个断点
  • 临时关闭监听:不想一直被调试打断的话,把电话图标关掉就行

还有一个小建议:如果你经常调试同一个页面,可以用书签加上调试参数,或者装个浏览器插件帮你自动附加参数。

基本上就这些。配置一次之后,后续开发过程中基本不需要再动了,远程开发体验会顺畅很多。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
phpstorm怎么导出项目
phpstorm怎么导出项目

phpstorm提供导出项目功能,步骤如下:打开phpstorm项目转到“项目”菜单选择“导出项目”选择导出格式指定导出位置选择导出范围勾选“包括依赖项”框(可选)单击“导出”完成导出。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

364

2024.04.08

phpStorm怎么运行
phpStorm怎么运行

本专题整合了phpstorm运行教程,阅读专题下面的文章了解更多相关内容。

85

2025.09.18

phpstorm开发环境搭建教程
phpstorm开发环境搭建教程

本专题整合了phpstorm开发环境搭建和运行项目教程,阅读专题下面的文章了解更多详细教程。

77

2025.09.18

phpstorm怎样运行php
phpstorm怎样运行php

本专题整合了phpstorm运行php相关教程,阅读专题下面的文章了解更多详细内容。

62

2025.09.18

phpstorm相关教程大全
phpstorm相关教程大全

本专题整合了phpstorm相关教程汇总,阅读专题下面的文章了解更多详细内容。

12

2026.01.15

apache是什么意思
apache是什么意思

Apache是Apache HTTP Server的简称,是一个开源的Web服务器软件。是目前全球使用最广泛的Web服务器软件之一,由Apache软件基金会开发和维护,Apache具有稳定、安全和高性能的特点,得益于其成熟的开发和广泛的应用实践,被广泛用于托管网站、搭建Web应用程序、构建Web服务和代理等场景。本专题为大家提供了Apache相关的各种文章、以及下载和课程,希望对各位有所帮助。

411

2023.08.23

apache启动失败
apache启动失败

Apache启动失败可能有多种原因。需要检查日志文件、检查配置文件等等。想了解更多apache启动的相关内容,可以阅读本专题下面的文章。

931

2024.01.16

http500解决方法
http500解决方法

http500解决方法有检查服务器日志、检查代码错误、检查服务器配置、检查文件和目录权限、检查资源不足、更新软件版本、重启服务器或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

422

2023.11.09

java入门学习合集
java入门学习合集

本专题整合了java入门学习指南、初学者项目实战、入门到精通等等内容,阅读专题下面的文章了解更多详细学习方法。

1

2026.01.29

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Node.js 教程
Node.js 教程

共57课时 | 9.6万人学习

Rust 教程
Rust 教程

共28课时 | 5万人学习

Vue 教程
Vue 教程

共42课时 | 7.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号