IntelliJ IDEA：创建PHP调试服务器配置

创建PHP调试服务器配置

此功能仅在Ultimate版本中受支持。
以下内容仅在安装并启用PHP插件时有效！

PHP调试服务器配置表示确保调试引擎与本地和远程Web服务器交互的HTTP访问的设置，并设置服务器上的文件与IntelliJ IDEA项目中的本地副本之间的对应关系。在使用PHP Web页或PHP远程调试类型的运行/调试配置以及在零配置调试会话期间进行调试时，将使用调试服务器配置中的设置 。

您可以从头开始手动创建调试服务器配置，也可以从服务器访问（部署）配置中导入一些设置。

手动定义调试服务器配置

1. 按下Ctrl+Alt+S或选择：文件|设置（对于Windows和Linux），或IntelliJ IDEA|首选项（对于macOS）以打开“设置/首选项对话框”。展开“语言和框架”节点，然后单击“PHP”下的“服务器”。
   或者，单击“运行/调试配置：PHP Web页”对话框中的“服务器”下拉列表旁边的 。
   在任何一种情况下，都会打开“服务器”页面，其左侧窗格显示所有可用的调试服务器配置。单击工具栏的 ，并在右侧窗格中指定调试服务器设置。
2. 指定调试服务器配置名称。
3. 指定运行应用程序的主机以及访问它的端口。
4. 从“调试器”下拉列表中，选择要使用的调试引擎。
5. 指定IntelliJ IDEA如何设置服务器上的文件与其本地副本之间的对应关系。基于这些映射，IntelliJ IDEA将打开当前处理文件的本地副本。在PHP调试服务器配置中的路径映射看起来非常类似于服务器访问（部署配置）的路径映射。不幸的是，它们无法重用，因为部署配置使用相对路径，而PHP调试服务器配置依靠绝对路径。
   • 如果您正在使用远程Web服务器，则选择“使用路径映射”复选框，即，当Web服务器位于物理远程主机上，或者Web服务器安装在计算机上但项目位于Web服务器文档根目录之外时。如果您使用符号链接，也请选中该复选框。
     分别使用服务器上的“路径”和“文件/目录”字段将具有绝对路径的服务器上的文件和文件夹的绝对路径映射到本地文件系统中的项目文件。
     • 文件/目录：此只读字段显示当前项目的文件和文件夹。选择要用作本地副本的文件或文件夹。
     • 服务器上的路径：在此字段中, 指定所选本地文件或文件夹对应的目标服务器上的文件或文件夹的绝对路径。手动键入路径或从列表中选择它。
   • 如果您在Web服务器上正常工作 ，请清除“ 使用路径映射”复选框，以便项目根位于服务器文档根目录下。在这种情况下，Web服务器上文件的绝对路径和项目中相应文件的绝对路径是相同的。
   如果未指定任何路径映射并开始调试不在服务器文档根目录下的应用程序，则IntelliJ IDEA将显示错误消息：
   
   
   “单击以设置路径映射”链接将显示“解析路径映射问题”对话框，您可以在其中定义路径映射：
   
   
   单击“确定”并退出对话框时，IntelliJ IDEA会自动选中“服务器”页面上的“使用路径映射”复选框。
   
6. 选中“共享”复选框以在团队中共享调试服务器配置。主机/端口设置和路径映射存储在.idea/php.xml文件中，可通过版本控制系统供所有团队成员使用。请注意，映射仅针对项目内的目录共享。

从服务器访问（部署）配置导入设置

1. 按下Ctrl+Alt+S或选择：文件|设置（对于Windows和Linux），或IntelliJ IDEA|首选项（对于macOS）以打开“设置/首选项对话框”。展开“语言和框架”节点，然后单击“PHP下的服务器”。
   或者，单击“运行/调试配置：PHP Web页”对话框中的“服务器”下拉列表旁边的 。
   在任何一种情况下，都会打开“服务器”页面，其左侧窗格显示所有可用的调试服务器配置。单击工具栏上的 。将打开“从部署配置导入”对话框。
2. 从“部署”列表中，选择要从中复制服务器访问设置的服务器访问配置（部署配置）。该列表包含所有可用的部署配置。要创建新配置，请在打开的“部署：连接选项卡”对话框中单击 并指定新设置。
3. 根据从“部署”列表中选择的服务器访问配置的类型，指定以下选项之一：
   • 对于FTP，SFTP或FTPS服务器访问配置，请指定服务器部署根目录的绝对路径。此路径将作为前缀添加到“部署：连接”选项卡上“根路径”字段的路径中。
     如果您不确定此绝对路径，可以打开“远程主机”工具窗口，选择所需的部署配置，将光标置于根文件夹，然后在上下文菜单中选择“复制路径”。或者，联系您的托管服务提供商。
   • 对于“本地”或“已安装”文件夹，键入服务器根目录的绝对路径，如“创建PHP调试服务器配置”对话框的“文件夹”字段中所指定。
   • 对于实时服务器配置，不需要映射，因为在这种情况下本地和远程路径是相同的。
4. 在预览区域显示了主机/端口，并从所选择的服务器的访问配置（部署配置）中检索到的路径的映射。
   选择要使用的部署配置时，“服务器上的绝对路径”字段显示映射到所选配置中的项目文件和文件夹的相对路径，即相对于部署根目录的文件和文件夹的路径。当您指定部署根目录（FTP/SFTP/FTPS的服务器根目录或已安装的文件夹）的绝对路径时，该字段的内容会自动更新，最后该字段显示服务器上的绝对路径。