创建 PHP 调试服务器配置

在设置/首选项对话框 ( Ctrl+Alt+S) 中，转到PHP | 服务器。

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

无论哪种情况，服务器页面都会打开，左侧窗格显示所有可用的调试服务器配置。单击工具栏上的 并在右侧窗格中指定调试服务器设置。

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

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

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

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

PHP 调试服务器配置中的路径映射看起来与服务器访问（部署）配置中的路径映射非常相似。不幸的是，它们不能被重用，因为部署配置使用相对路径，而PHP 调试服务器配置依赖于绝对路径。

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

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

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

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

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

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

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

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

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

在设置/首选项对话框 ( Ctrl+Alt+S) 中，转到PHP | 服务器。

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

无论哪种情况，服务器页面都会打开，左侧窗格显示所有可用的调试服务器配置。单击工具栏上的 。“从部署配置导入”对话框打开。

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

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

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

  此路径将作为前缀添加到Deployment: Connection 选项卡上的根路径字段中的路径。

  如果您不确定这个绝对路径，您可以打开远程主机工具窗口，选择所需的部署配置，将插入符号放在根文件夹中，然后从上下文菜单中选择复制路径，请参阅访问 Web 服务器上的文件了解详细信息. 或者，联系您的托管服务提供商。

• 对于Local ormounted folder ，键入在部署：连接选项卡对话框的文件夹字段中指定的服务器根目录的绝对路径。

• 对于Inplace Server配置，不需要映射，因为在这种情况下本地和远程路径是相同的。

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

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