当前位置:

首页 > 编程开发 > Ubuntu上PHPStorm如何使用远程解释器

Ubuntu上PHPStorm如何使用远程解释器

Ubuntu 上 PHPStorm 使用远程解释器的完整步骤 一 准备远程环境 想让 PHPStorm 在远程 Ubuntu 主机上跑起来,第一步得把“地基”打好。这主要涉及两样东西:一个是 PHP CLI,负责命令行执行,充当 PHPStorm 的解释器核心;另一个是 OpenSSH 服务器,它是

本文目录

    Ubuntu 上 PHPStorm 使用远程解释器的完整步骤

    Ubuntu上PHPStorm如何使用远程解释器

    一 准备远程环境

    想让 PHPStorm 在远程 Ubuntu 主机上跑起来,第一步得把“地基”打好。这主要涉及两样东西:一个是 PHP CLI,负责命令行执行,充当 PHPStorm 的解释器核心;另一个是 OpenSSH 服务器,它是文件同步和远程命令执行的桥梁。

    操作很简单,在远程主机上执行以下命令即可:

    sudo apt update
    sudo apt install php-cli openssh-server

    接下来,确保远程主机能通过 SSH(默认端口 22)访问,并准备好你的登录凭证——密码或者更推荐的 SSH 密钥对。如果选择密钥方式,记得把公钥添加到远程主机的 ~/.ssh/authorized_keys 文件里,并且权限设置要到位:

    chmod 700 ~/.ssh
    chmod 600 ~/.ssh/authorized_keys

    完成这些,远程环境就基本就绪,可以接受 PHPStorm 的 SSH 连接和同步了。

    二 在 PHPStorm 添加远程解释器

    环境备好,接下来就是在 PHPStorm 里“认路”了。打开你的项目,进入 File → Settings → Languages & Frameworks → PHP → CLI Interpreter,点击右上角的齿轮图标,选择 Add…。

    在弹出的窗口中,选择 SSH Interpreter。然后,填入远程主机的连接信息:主机地址(Host)、端口(通常是 22)、用户名。认证方式可以选择密码,但更安全、更推荐的是使用私钥文件(Private key file)。

    点击测试连接,成功后,最关键的一步来了:指定远程 PHP 可执行文件的路径,比如 /usr/bin/php。确认后,解释器就添加成功了。

    这里有个小建议:顺手勾选上 Sync folders 选项。当然,你也可以在后续的部署配置里再详细设置映射关系。这一步的目的是确保本地和远程的目录能同步,真正做到在本地优雅地写代码,在远程高效地运行和调试。

    三 配置 Deployment 文件同步与映射

    解释器配好了,但代码文件还在本地。如何让它们“瞬移”到远程服务器呢?这就需要配置部署(Deployment)同步。

    进入 File → Settings → Deployment → Configuration,点击 + 号,选择 SFTP 新建一个连接。这里的 SSH 配置信息,直接复用刚才添加解释器时填写的就行。

    配置的重头戏在 Mappings 标签页。你需要在这里建立本地项目根目录和远程项目根目录的对应关系。举个例子:本地 /home/user/project 对应 远程 /var/www/project。

    为了省心,可以开启自动上传功能(比如勾选 Upload changed files automatically to the default server)。如果追求更精确的控制,也可以通过 Tools → Deployment → Sync 进行手动同步。核心目标只有一个:确保远程环境里的代码永远是最新的。

    四 运行与调试配合远程解释器

    万事俱备,只欠执行。现在,你可以让代码在远程解释器上跑起来了。

    运行配置:打开 Run/Debug Configurations,新建一个 PHP Script 或 PHP Built-in Web Server 等运行类型。关键点在于,在解释器选项里,选择你刚刚添加的那个 Remote/SSH Interpreter。如果是 Web 运行类型,别忘了正确指定远程的 Document root 和端口。

    远程调试(可选,需 Xdebug):这才是体现生产力的高级玩法。首先,在远程服务器上安装并配置 Xdebug 3。配置文件里通常需要这几行:

    zend_extension=xdebug.so
    xdebug.mode=debug
    xdebug.client_host=127.0.0.1
    xdebug.client_port=9003
    xdebug.start_with_request=yes
    xdebug.idekey=PHPSTORM

    然后,回到 PHPStorm,进入 Settings → PHP → Debug,将 Debug port 设置为 9003(与远程配置一致),并开启 Start Listening for PHP Debug Connections。当你在浏览器访问远程应用时,只要带上 XDEBUG_SESSION_START=PHPSTORM 参数,就能触发断点,实现远程调试。

    五 常见问题与排查

    流程看似顺畅,但实际操作时难免会遇到些“小石头”。这里列举几个常见问题,帮你快速排障:

    • 连接失败:首先检查远程 SSH 服务是否在运行(sudo systemctl status ssh),其次确认端口和防火墙策略是否放行。
    • 权限问题:确保用于登录的 SSH 密钥或用户账户,对远程项目目录拥有读写权限。同时,本地的私钥文件权限应设置为 600。
    • 找不到 PHP:在远程主机上执行 which php 命令,确认 PHP 可执行文件的确切路径,然后在 PHPStorm 的解释器配置中手动指定这个正确路径。
    • 同步异常:仔细核对 Deployment → Mappings 中设置的本地与远程路径是否一一对应。如果仍有问题,尝试手动执行一次 Sync 操作。
    • 调试连不上:确认远程 Xdebug 配置中的 xdebug.client_port 与 PHPStorm 中设置的 Debug port 完全一致。如果远程环境在 Docker 或内网中,client_host 的设置需要格外注意,要确保能正确回连到你的开发机。
    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发 Ubuntu
    相关文章 更多
    Ubuntu命令行入门:打开终端并验证文件目录操作
    Ubuntu命令行入门:打开终端并验证文件目录操作

    本教程指导Ubuntu新手打开终端,通过pwd、ls、cd、mkdir和touch命令完成基础文件目录操作。适用于桌面版、虚拟机及WSL环境,提供从查看路径到创建测试文件的完整验证步骤,帮助读者建立命令行操作的安全意识与正确习惯。

    在VMware中安装Ubuntu并验证启动的完整步骤
    在VMware中安装Ubuntu并验证启动的完整步骤

    本文提供在VMware中安装Ubuntu并验证启动的完整流程。适用于首次练习Linux或搭建开发环境的用户。按步骤完成虚拟机创建、ISO挂载、硬件分配与安装后,可通过终端命令确认版本、内核与网络状态,确保系统可正常使用。

    Ubuntu 26.04 将显著提升英伟达图形显卡在 Wayland 环境下的性能
    Ubuntu 26.04 将显著提升英伟达图形显卡在 Wayland 环境下的性能

    Ubuntu26.04LTS针对英伟达显卡在Wayland+GNOME环境进行性能调优,通过修改gbm_surface_lock_front_buffer函数,将帧渲染等待时间从毫秒级降至微秒级,显著提升UI响应和画面流畅度。该补丁已作为发行版专属补丁集成,确保LTS用户无需等待上游整合即可获得优化体验。

    Ubuntu Touch 24.04-2.0 Beta 发布:适配索尼 Xperia X 等手机 提升上网体验
    Ubuntu Touch 24.04-2.0 Beta 发布:适配索尼 Xperia X 等手机 提升上网体验

    UbuntuTouch24.04-2.0Beta发布,底层升级至Ubuntu24.04,浏览器引擎从Chromium87跃升至134,网页兼容性显著提升;新增屏幕刘海区域自动适配、截图编辑器、网络指示器改进、移动数据可靠性增强、数据加密稳定,并新增NothingPhone(1)等设备支持。

    Ubuntu如何查看系统防火墙规则
    Ubuntu如何查看系统防火墙规则

    ufw status仅显示高层策略和显式添加的规则(如“80 ALLOW Anywhere”),不反映默认策略绕过、IPv6独立规则、Docker等直写nftables的bypass规则,也无法体现本地回环流量不受管控等底层细节。Ubuntu 默认用 ufw 管理防火墙,但规则实际由 nftable

    Ubuntu如何更换锁屏背景图片
    Ubuntu如何更换锁屏背景图片

    锁屏背景和桌面壁纸之所以不同,是因为GNOME默认会复制桌面壁纸,然后强制叠加高斯模糊和亮度调整效果,这个效果是由lockDialogGroup的CSS来控制的。要是想去除模糊,建议使用Control Blur Effect On Lock Screen扩展,把Adjust Sigma设置为0就行。

    UbuntuSwapper在服务器上应用效果如何
    UbuntuSwapper在服务器上应用效果如何

    Ubuntu Swapper(一般就是指Ubuntu的交换分区或者交换文件)在服务器上的应用成效,是由多个因素共同决定的,像服务器的硬件配置情况、工作负载的类型以及交换空间的大小和具体配置等。下面为大家带来一些有关Ubuntu Swapper在服务器上应用效果的一般性评价:正面效果内存管理:交换空间

    Ubuntu如何配置命令行模式下的中文支持
    Ubuntu如何配置命令行模式下的中文支持

    根本原因是纯命令行tty默认不支持UTF-8及中文字体渲染,locale设置仅影响字符解析逻辑,不解决字体绘制问题;图形终端自带UTF-8渲染,而tty需借助fbterm等工具实现中文显示。为什么终端里中文显示为问号或方块 纯命令行(tty,例如通过Ctrl+Alt+F3进入的界面)默认不会加载UT

    如何通过Tomcat日志提升Ubuntu服务器性能
    如何通过Tomcat日志提升Ubuntu服务器性能

    通过分析Tomcat日志来提升Ubuntu服务器性能是一个很好的方法。以下是一些步骤和建议,帮助你通过Tomcat日志来优化服务器性能:1. 收集日志首先,得保证你的Tomcat服务器有详细的日志记录配置。在conf/logging.properties文件里,你可以对日志级别和输出格式进行调整。o

    Ubuntu如何设置具体的命令行配色
    Ubuntu如何设置具体的命令行配色

    直接修改PS1是最为可控且轻量的方法。因为GNOME Terminal主题难以区分提示符、命令输入与输出,而PS1搭配ANSI转义码能够精准地为各个字段上色,并且需要用[ ]进行包裹,以防止光标出现错位的情况。直接改 PS1 是最可控、最轻量的方式,不需要装框架或改终端全局配色。 为什么不用改 GN

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。