PhpStorm 2021.3 Help

服务器

该页面仅在启用PHP插件时可用。PHP插件与PhpStorm 捆绑在一起并默认激活。如果插件被禁用,请在设置/首选项的已安装选项卡上启用它。插件页面,如管理插件中所述。

在此页面上,为调试引擎配置 HTTP 访问以与本地和远程 Web 服务器交互,并设置服务器上的文件与其在 PhpStorm 项目中的本地副本之间的对应关系。在使用PHP 网页PHP 远程调试类型的运行/调试配置进行调试时以及在零配置调试会话期间使用调试服务器配置中的设置。

工具栏和常用选项

使用工具栏按钮管理配置列表。

物品

工具提示和快捷方式

描述

添加按钮

添加

Insert

单击此按钮可定义新配置。

删除按钮

删除

Delete

单击此按钮可从列表中删除选定的配置。

导入按钮

进口

单击此按钮可打开“从部署配置导入导入”对话框。在此对话框中,选择配置以访问服务器上的应用程序并使用其中的主机和端口设置。

该对话框还显示从部署配置中检索到的路径映射。您需要将服务器上的相对路径转换为绝对路径:

  • 对于FTPSFTPFTPS服务器访问配置,请指定服务器部署根目录的绝对路径。此路径将作为前缀添加到Deployment: Connection 选项卡上的根路径字段中的路径。

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

  • 对于类型为Local 或 Mounted Folder的服务器访问配置,请指定服务器文档根目录或已安装文件夹的绝对路径。此路径应该是Deployment: Connection Tab上的Folder字段中指定的路径。

  • 对于Inplace Server配置,不需要映射,因为本地和远程路径相同。

有关详细信息,请参阅配置与 Web 服务器的同步。

配置详情

在此区域中,指定调试会话期间要使用的连接参数和映射。请注意,验证远程环境按钮已从此页面中删除,此功能现在可通过运行 | 主菜单中的Web 服务器调试验证

物品

描述

姓名

在此字段中,输入服务器调试配置的名称。

主持人

在此字段中,键入部署目标应用程序的主机的名称。

港口

在此字段中,输入连接到指定主机的端口。如果您在机器上使用localhost,此设置应与本地 Web 服务器的配置文件中指定的端口相对应,应用程序将在该配置文件中执行或调试。

调试器

从此列表中,选择要使用的调试引擎。可用的选项有:

  • Xdebug

  • Zend 调试器

使用路径映射

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

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

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

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

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

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

调试映射未配置错误 message.png

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

修复调试映射配置.png

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

共享

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

最后修改时间:2022 年 1 月 26 日