讲师中心 微信公众号
AI工具推荐 视频效率加速

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

胖明大大_8569

胖明大大_8569

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

|

663人浏览过

|

来源于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 标签。这里需要设置三项:

page-agent 浏览器控制(CDP)
page-agent 浏览器控制(CDP)

使用 page-agent CLI(CDP)控制浏览器;CLI只能通过 GitHub Release 的 .tgz 安装,npm 官方包暂未发布。

下载
  • 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工具

更多
AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

相关专题

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

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

1428

2024.04.08

phpStorm怎么运行
phpStorm怎么运行

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

6278

2025.09.18

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

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

6376

2025.09.18

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

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

2241

2025.09.18

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

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

138

2026.01.15

从环境搭建到代码调试:PHPstorm全流程开发配置指南
从环境搭建到代码调试:PHPstorm全流程开发配置指南

本文旨在为PHP开发者提供一份详尽的PhpStorm全流程开发配置指南。内容涵盖从IDE安装、PHP解释器配置、Xdebug调试环境搭建,到项目运行与断点调试的完整流程。通过本指南,读者将掌握搭建高效开发环境的核心技能,快速上手PhpStorm的强大功能,显著提升PHP开发效率。

141

2026.04.01

PHPstorm编辑器全系统安装与激活配置指南
PHPstorm编辑器全系统安装与激活配置指南

本文提供一份详尽的PHPstorm全系统安装与激活配置指南,覆盖Windows、macOS及Linux三大主流平台。内容从官方安装包的获取、安装过程中的路径与组件选择,到激活流程(包括正版激活与补丁替换法)均有详细图解。此外,指南还包含安装后的基础环境配置与中文语言包安装,旨在帮助开发者快速完成IDE部署,为PHP开发搭建一个稳定、高效的集成环境。

276

2026.04.01

ps软件新手入门教程合集
ps软件新手入门教程合集

PHP中文网精心打造了本PS新手入门教程合集。内容涵盖软件安装、界面认知、图层管理及抠图调色等核心技能,提供从零基础到精通的系统化学习路径。无论您是想快速上手修图还是进阶平面设计,都能在此找到实用指南与实战案例,助您轻松玩转Photoshop。

1020

2026.06.11

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

60

2026.10.22

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
安装 Xdebug 并配置 phpstorm
安装 Xdebug 并配置 phpstorm

共1课时 | 192人学习

3分钟内将Xdebug安装到PHP
3分钟内将Xdebug安装到PHP

共1课时 | 171人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn