从部署配置导入对话框

仅当启用了 PHP 和 FTP/SFTP/WebDAV Connectivity 插件时，此对话框才可用。这些插件 未 与 PhpStorm 捆绑，但可以按照从 JetBrains Marketplace 安装插件中的说明，在设置 | 插件页面上安装。启用后，这些插件在 IDE 级别可用，也就是说，您可以在所有 PhpStorm 项目中使用它们。

当您单击时，对话框将在服务器页面的工具栏中打开。

在此对话框中，选择一个配置以访问服务器上的应用程序，并使用其中的主机和端口设置。

项目	描述
部署(D)	从此列表中选择服务器访问配置（部署配置），以复制服务器访问设置。列表包含所有可用的部署配置。要创建新配置，请单击，并在打开的部署：连接选项卡对话框中指定新设置。在下方字段中，指定服务器部署根文件夹的绝对路径。字段名称取决于所选服务器访问配置的类型：部署根目录的绝对路径用于 FTP/SFTP/FTPS ，或挂载文件夹的远程路径用于本地或挂载文件夹。此路径将作为前缀添加到根路径(R) 字段中的路径部署：连接选项卡。如果您不确定此绝对路径，可以打开远程主机工具窗口，选择所需的部署配置，将光标放在根文件夹上，然后从上下文菜单中选择复制路径。有关更多信息，请参阅访问服务器上的文件。或者，联系您的托管服务提供商。
部署根的绝对路径或挂载文件夹的远程路径	根据从部署列表中选择的服务器访问配置类型，指定以下之一：对于 FTP、 SFTP或 FTPS服务器访问配置，指定服务器部署根目录的绝对路径。此路径将作为前缀添加到根路径(R) 字段中的路径部署：连接选项卡。如果您不确定此绝对路径，可以打开远程主机工具窗口，选择所需的部署配置，将光标放在根文件夹上，然后从上下文菜单中选择复制路径。有关更多信息，请参阅访问服务器上的文件。或者，联系您的托管服务提供商。对于本地或挂载文件夹，请输入服务器根目录的绝对路径，如文件夹字段中部署：连接选项卡对话框所指定。对于就地服务器配置，不需要映射，因为在这种情况下，本地路径和远程路径相同。
预览	该区域显示从所选服务器访问配置（部署配置）中检索到的主机/端口和路径映射。当您选择要使用的部署配置时，服务器上的绝对路径字段显示相对于部署根目录的项目文件和文件夹的相对路径。当您指定部署根目录的绝对路径（FTP/SFTP/FTPS/WebDAV 的服务器根目录或挂载文件夹）时，字段内容会自动更新，最终字段显示服务器上的绝对路径。指定 PhpStorm 如何在服务器上的文件与其本地副本之间建立对应关系。基于这些映射，PhpStorm 将打开当前处理文件的本地副本。 PHP 调试服务器配置中的路径映射与服务器访问（部署）配置中的路径映射非常相似。遗憾的是，它们无法重用，因为部署配置使用相对路径，而 PHP 调试服务器配置依赖于绝对路径。无法为标记为排除的项目文件或文件夹设置路径映射。如果您正在远程 Web 服务器上工作，即 Web 服务器位于物理远程主机上，或者 Web 服务器安装在您的机器上但您的项目位于 Web 服务器文档根目录之外，请选中使用路径映射复选框。如果您使用符号链接，也请选中此复选框。使用服务器上的绝对路径和文件/目录字段分别将服务器上文件和文件夹的绝对路径映射到本地文件系统中项目文件的绝对路径。文件/目录此只读字段显示当前项目的文件和文件夹。选择一个文件或文件夹作为本地副本。服务器上的绝对路径在此字段中，指定目标服务器上与所选本地文件或文件夹对应的文件或文件夹的绝对路径。手动输入路径或从列表中选择。如果您直接在 Web 服务器上工作，因此您的项目根目录位于服务器文档根目录下，请清除使用路径映射复选框。在这种情况下，Web 服务器上的文件绝对路径与项目中对应文件的绝对路径相同。如果您未指定任何路径映射并开始调试不在服务器文档根目录下的应用程序，PhpStorm 将显示一条错误消息：点击以设置路径映射链接会打开解决路径映射问题对话框，您可以在其中定义路径映射：当您单击确定并离开对话框时，使用路径映射复选框将在服务器页面上自动选中。

项目

描述

部署(D)

从此列表中选择服务器访问配置（部署配置），以复制服务器访问设置。列表包含所有可用的部署配置。要创建新配置，请单击，并在打开的部署：连接选项卡对话框中指定新设置。

在下方字段中，指定服务器部署根文件夹的绝对路径。字段名称取决于所选服务器访问配置的类型：部署根目录的绝对路径用于 FTP/SFTP/FTPS ，或挂载文件夹的远程路径用于本地或挂载文件夹。

此路径将作为前缀添加到根路径(R) 字段中的路径部署：连接选项卡。

如果您不确定此绝对路径，可以打开远程主机工具窗口，选择所需的部署配置，将光标放在根文件夹上，然后从上下文菜单中选择复制路径。有关更多信息，请参阅访问服务器上的文件。或者，联系您的托管服务提供商。

部署根的绝对路径或挂载文件夹的远程路径

根据从部署列表中选择的服务器访问配置类型，指定以下之一：

对于 FTP、 SFTP或 FTPS服务器访问配置，指定服务器部署根目录的绝对路径。
此路径将作为前缀添加到根路径(R) 字段中的路径部署：连接选项卡。
如果您不确定此绝对路径，可以打开远程主机工具窗口，选择所需的部署配置，将光标放在根文件夹上，然后从上下文菜单中选择复制路径。有关更多信息，请参阅访问服务器上的文件。或者，联系您的托管服务提供商。
对于本地或挂载文件夹，请输入服务器根目录的绝对路径，如文件夹字段中部署：连接选项卡对话框所指定。
对于就地服务器配置，不需要映射，因为在这种情况下，本地路径和远程路径相同。

预览

该区域显示从所选服务器访问配置（部署配置）中检索到的主机/端口和路径映射。

当您选择要使用的部署配置时，服务器上的绝对路径字段显示相对于部署根目录的项目文件和文件夹的相对路径。当您指定部署根目录的绝对路径（FTP/SFTP/FTPS/WebDAV 的服务器根目录或挂载文件夹）时，字段内容会自动更新，最终字段显示服务器上的绝对路径。

指定 PhpStorm 如何在服务器上的文件与其本地副本之间建立对应关系。基于这些映射，PhpStorm 将打开当前处理文件的本地副本。

PHP 调试服务器配置中的路径映射与服务器访问（部署）配置中的路径映射非常相似。遗憾的是，它们无法重用，因为部署配置使用相对路径，而 PHP 调试服务器配置依赖于绝对路径。

如果您正在远程 Web 服务器上工作，即 Web 服务器位于物理远程主机上，或者 Web 服务器安装在您的机器上但您的项目位于 Web 服务器文档根目录之外，请选中使用路径映射复选框。如果您使用符号链接，也请选中此复选框。
使用服务器上的绝对路径和文件/目录字段分别将服务器上文件和文件夹的绝对路径映射到本地文件系统中项目文件的绝对路径。
- 文件/目录此只读字段显示当前项目的文件和文件夹。选择一个文件或文件夹作为本地副本。
- 服务器上的绝对路径在此字段中，指定目标服务器上与所选本地文件或文件夹对应的文件或文件夹的绝对路径。手动输入路径或从列表中选择。
如果您直接在 Web 服务器上工作，因此您的项目根目录位于服务器文档根目录下，请清除使用路径映射复选框。在这种情况下，Web 服务器上的文件绝对路径与项目中对应文件的绝对路径相同。

如果您未指定任何路径映射并开始调试不在服务器文档根目录下的应用程序，PhpStorm 将显示一条错误消息：

点击以设置路径映射链接会打开解决路径映射问题对话框，您可以在其中定义路径映射：

当您单击确定并离开对话框时，使用路径映射复选框将在服务器页面上自动选中。

最后修改日期： 2025年 9月 26日