PhpStorm 2025.2 Help

部署：连接选项卡

使用此选项卡选择 访问 Web 服务器的方式并指定连接设置。 控件集取决于选择的服务器访问类型。

所有服务器类型的常见设置

项目

描述

仅对此项目可见

选中此复选框以启用在其他项目中重用此服务器访问配置或服务器组。

  • 选中复选框以将配置或服务器组的使用限制在当前项目。 此配置或服务器组无法在当前项目之外重复使用。 它没有出现在其他项目的可用配置列表中。

    服务器配置设置存储在 .idea 目录中， 与项目一起，这允许团队成员 通过 VCS进行共享。

    在左侧面板的服务器访问配置列表中，当前项目中仅可见的配置标有 仅在当前项目中可见的图标 图标。

  • 当复选框被清除时，配置或服务器组在所有 PhpStorm 项目中可见。 其设置可以在多个项目中重复使用。

有关设置解释器的更多信息，请参阅 配置远程 PHP 解释器 和 通过 SSH 使用 Node.js。

Type

在此列表中选择访问服务器的方式。 可用选项包括：

  • FTP ：选择此选项让 PhpStorm 通过 FTP 文件传输协议 访问服务器。

  • SFTP ：选择此选项，使 PhpStorm 通过 SFTP 文件传输协议访问服务器。

  • FTPS ：选择此选项可通过 SSL 的 FTP 文件传输协议（FTPS 扩展）让 PhpStorm 访问服务器。

  • WebDAV ：选择此选项以便 PhpStorm 通过 WebDAV 文件传输协议（WebDAV 扩展名）访问服务器。

Web 服务器 URL(W)

在此字段中，指定与服务器配置文件中指定的服务器文档目录相对应的 URL 地址。 请在该字段中点击 在浏览器中打开 URL 图标 以确保指定的服务器根 URL 地址可访问并指向正确的网页。

同时支持 HTTP 和 HTTPS。

FTP 和 FTPS 设置

项目

描述

主机

在此字段中，指定要上传文件到的服务器主机名。

端口

在此字段中，指定要使用的端口。 默认值是 21。

根路径(R)

在此字段中，指定用于浏览远程文件系统以及设置服务器路径映射和排除路径的远程目录根文件夹。

请执行以下操作之一：

  • 接受默认的 / 路径，它指向服务器上的 root 文件夹。

  • 手动输入路径或点击 浏览按钮 并在打开的 选择根路径 对话框中选择所需文件夹。

  • 点击 自动检测。 PhpStorm 会检测 FTP/SFTP 服务器上的用户主文件夹设置，并根据这些设置配置根路径。 只有在指定了您的凭证时，按钮才会启用。

自动检测

点击此按钮，令 PhpStorm 检测服务器上的用户主文件夹设置并相应地设置 根路径。

用户名

在此字段中输入您的用户名以进行服务器身份验证。

密码

在该字段中输入您的密码以验证服务器身份。

匿名登录(N)

选中此复选框以启用 匿名访问服务器，并使用您的电子邮件地址作为密码。

保存密码(V)

选中此复选框以使 PhpStorm 记住指定的密码。

测试连接(C)

点击此按钮以检查指定的设置是否确保成功连接。 按钮仅在您指定您的用户凭证时启用。

FTP 和 FTPS 高级设置

在 高级 区域，您可以通过为 FTP/FTPS 服务器配置指定额外的协议特定选项来自定义上传/下载。

项目

描述

适用于

TLS

选择调用客户端安全性的方法：

  • 显式(X) ：应用了 显式（主动）安全性。 在连接建立后，您机器上的 FTP 客户端会向服务器发送命令，通过默认的 FTP 端口建立安全控制连接。

  • 隐式(I) ：应用了 隐式（被动）安全性。 在这种情况下，安全性在与服务器建立连接时自动提供，该服务器设置了一个用于安全连接的独立端口。

    请注意， Implicit 方法已被视为弃用，不建议使用。

FTPS

数据通道保护级别(D)

从此列表中，为 PROT 命令设置保护级别：

  • <default> ：已应用默认服务器策略。

  • 清除 ：原始数据在没有应用安全措施的情况下被传输。

  • Private ：已应用传输层安全 (TLS) 或安全套接字层 (SSL)。

如需更多信息，请参阅有关 TLS、 SSL 2.0和 SSL 3.0的文章。

FTPS

重用SSL 会话

选中此复选框以连接到需要在控制和数据连接之间重复使用 SSL 会话的服务器。

FTPS

禁用TLS 1.3

选择禁用 TLS 1.3 功能，并让 PhpStorm 回退到通过 TLS 1.2 进行连接。 如果您在连接服务器或上传某些文件时遇到问题，请使用此选项。

FTPS

被动模式(P)

选中此复选框以将您机器上的客户端设置为 被动模式 ，当它连接到服务器时，会通知处于被动模式，接收要监听的端口号，并通过接收到的端口号建立数据连接。 此模式在您的机器处于防火墙后面时非常有用。

FTP，FTPS

显示并处理隐藏文件(S)

选中此复选框时：

  1. 隐藏文件和目录显示在 Remote Host Tool Window中。

  2. 隐藏文件和目录会参与 diff 和 同步 操作。

隐藏文件或目录的名称以点开头 。 。

FTP，FTPS

使用LIST 命令

使用此区域中的选项配置 LIST 命令使用。

  • 与旧版本的列示子项兼容(C) ：选中此复选框以确保与您的 FTP 服务器在 子文件命名方面的兼容性。

    此选项在远程 FTP 服务器报告以下错误时很有帮助：

    Invalid descendant file name <file name>

    选择此选项可能会减慢与服务器的同步速度。

  • 代替MLSD ：选中此复选框以使用标准 LIST 命令列出内容，而不是 MLSD 命令。 这可以帮助您避免问题，例如，如果 FTP 服务器支持 MLSD 并返回 cdir ，在上传时因 无效的子文件名异常而失败。

FTP，FTPS

连接数(E)

在此字段中，指定要同时支持的最大连接数。

FTP，FTPS

发送保持活动消息的间隔(K)

在此字段中，指定您希望 PhpStorm 多久向服务器发送命令以重置超时，从而保持连接。

FTP，FTPS

保持活动命令(A)

从此列表中，选择要发送到服务器以重置超时并保持连接的命令。

FTP，FTPS

客户端-服务器通信编码 (E)

在此字段中，指定与您的服务器使用的编码相匹配的编码。 如果您不确定它是否支持 UTF-8编码，请接受默认值。

FTP，FTPS

SFTP 设置

项目

描述

SSH 配置(S)

从此列表中，选择已创建的 SSH 配置之一，或单击 “浏览”按钮 并按照 创建 SSH 配置 中的描述创建新配置。

测试连接(C)

点击此按钮以检查指定的设置是否确保成功连接。 按钮仅在您指定您的用户凭证时启用。

根路径(R)

在此字段中，指定用于浏览远程文件系统以及设置服务器路径映射和排除路径的远程目录根文件夹。

请执行以下操作之一：

  • 接受默认的 / 路径，它指向服务器上的 root 文件夹。

  • 手动输入路径或点击 浏览按钮 并在打开的 选择根路径 对话框中选择所需文件夹。

  • 点击 自动检测。 PhpStorm 会检测 FTP/SFTP 服务器上的用户主文件夹设置，并根据这些设置配置根路径。 只有在指定了您的凭证时，按钮才会启用。

使用 Rsync 进行下载/上传/同步

选中此复选框以使用 Rsync 来同步您的部署配置。

Rsync 设置

点击此链接以在打开的对话框中配置 Rsync 设置：

  • 提供 rsync 和 ssh 可执行文件的路径。

    • 在 macOS 和 Linux 上， rsync 和 ssh 工具是预装的，路径会自动填充。

    • 在 Windows 上，您需要手动安装 Cygwin 并首先包含 rsync 和 openssh 软件包。 工具的可执行文件通常位于 <Cygwin installation>\bin 文件夹中。

  • 如有必要，请覆盖 Rsync 选项 字段中的 Rsync 命令行参数。

    默认情况下，将使用 -zar 选项，以便 Rsync 将压缩传输的数据(z )，保留传输文件和文件夹的权限、所有权和时间戳(a )，并递归进入子目录(r)。

    要获取可用选项的完整列表，请参考 Rsync 文档。

SFTP 高级设置

在 高级 区域，通过为 SFTP 服务器配置指定附加的协议特定选项来自定义上传/下载。

项目

描述

连接数(E)

在此字段中，指定要同时支持的最大连接数。

发送保持活动消息的间隔(K)

在此字段中，指定您希望 PhpStorm 多久向服务器发送命令以重置超时，从而保持连接。

客户端-服务器通信编码 (E)

在此字段中，指定与您的服务器使用的编码相匹配的编码。 如果您不确定它是否支持 UTF-8编码，请接受默认值。

WebDAV 设置

项目

描述

主机

在此字段中，指定要上传文件到的服务器主机名。

端口

在此字段中，指定要使用的端口。 默认值是 6180。

用户名

在此字段中输入您的用户名以进行服务器身份验证。

密码

在该字段中输入您的密码以验证服务器身份。

匿名登录(N)

选中此复选框以启用匿名访问服务器。

保存密码(V)

选中此复选框以使 PhpStorm 记住指定的密码。

测试连接(C)

点击此按钮以检查指定的设置是否确保成功连接。

本地或挂载文件夹设置

项目

描述

文件夹(F)

在此字段中，指定在您的服务器配置文件中定义的服务器文档根目录的绝对路径。 除了文档根目录本身之外，您还可以指定文档根目录下的任何其他现有文件夹。

文档根目录是 Web 服务器将文件提供给 Web 服务器 URL 的文件夹。

最后修改日期： 2025年 9月 26日
部署部署：映射选项卡