创建 PHP 调试服务器配置

在 设置 对话框 (Ctrl+Alt+S) 中，前往 PHP | 服务器。

或者，单击 ，位于 服务器 列表旁边的 PHP 网页 对话框中。

在任一情况下， 服务器 页面将打开，左侧窗格显示所有可用的调试服务器配置。 单击工具栏上的 ，并在右侧窗格中指定调试服务器设置。

指定调试服务器配置名称。

指定运行应用程序的主机和访问它的端口。

从 调试器 列表中选择要使用的 调试引擎。

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

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

• 如果您正在远程 Web 服务器上工作，即 Web 服务器位于物理远程主机上，或者 Web 服务器安装在您的机器上但您的项目位于 Web 服务器文档根目录之外，请选中 使用路径映射 复选框。 如果您使用符号链接，也请选中此复选框。

  使用 服务器上的绝对路径 和 文件/目录 字段分别将服务器上文件和文件夹的绝对路径映射到本地文件系统中项目文件的绝对路径。

  • 文件/目录 此只读字段显示当前项目的文件和文件夹。 选择一个文件或文件夹作为本地副本。

  • 服务器上的绝对路径 在此字段中，指定目标服务器上与所选本地文件或文件夹对应的文件或文件夹的绝对路径。 手动输入路径或从列表中选择。

• 如果您直接在 Web 服务器上工作，因此您的项目根目录位于服务器文档根目录下，请清除 使用路径映射 复选框。 在这种情况下，Web 服务器上的文件绝对路径与项目中对应文件的绝对路径相同。

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

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

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

选中 共享 复选框以在团队中共享调试服务器配置。 主机/端口设置和路径映射存储在 .idea/php.xml 文件中，通过版本控制系统可供所有团队成员使用。 请注意，映射仅对项目内的目录共享。

在 设置 对话框 (Ctrl+Alt+S) 中，前往 PHP | 服务器。

或者，单击 ，位于 服务器 列表旁边的 PHP 网页 对话框中。

在任一情况下， 服务器 页面将打开，左侧窗格显示所有可用的调试服务器配置。 点击 工具栏。 从部署配置导入对话框 对话框已打开。

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

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

• 对于 FTP、 SFTP或 FTPS服务器访问配置，指定服务器部署根目录的绝对路径。

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

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

• 对于 本地或挂载文件夹 ，请输入 服务器根目录的绝对路径，如 文件夹 字段中 部署：连接选项卡 对话框所指定。

• 对于 就地服务器配置，不需要映射，因为在这种情况下，本地路径和远程路径相同。

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

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