PhpStorm 2025.2 Help

配置 PHP 远程解释器对话框

当您在 CLI 解释器 对话框的左侧窗格中单击 Add "添加"按钮 并从弹出菜单中选择 来自 Docker、Vagrant、VM、WSL、Remote 时,将打开此对话框。

使用此对话框配置对安装在远程主机或通过 VagrantDocker实例设置的开发环境中的 PHP 引擎的访问。

项目

描述

SSH

选择此选项以通过 SSH 凭据配置对远程主机上的 PHP 解释器的访问。 从 SSH 配置 列表中选择已创建的 SSH 配置之一,或单击 “浏览”按钮 并按照 创建 SSH 配置 中的说明创建一个新配置。

要使用解释器配置,您需要 路径映射 ,以设置项目文件夹、服务器上用于复制项目文件的文件夹以及访问服务器上复制数据的 URL 地址之间的对应关系。

PhpStorm 首先尝试通过处理所有可用的应用程序级配置来自行检索路径映射。 如果 PhpStorm 找到与所选 SSH 配置中指定的主机相同的配置,则这些配置的映射会自动合并。

如果未找到包含此主机的配置,PhpStorm 会显示一条错误消息,通知您路径映射未配置。

要解决此问题,请打开 部署 页面,位于 构建、执行、部署 节点下,选择服务器访问配置,切换到 映射 选项卡,并按照 创建远程服务器配置将本地文件夹映射到服务器上的文件夹以及访问它们的 URL 地址 部分的说明,将本地文件夹映射到服务器上的文件夹。

Docker

仅当启用了 PHP DockerDocker插件时,此选项才可用。 这些插件默认是激活的。 如果插件被禁用,请按照 安装插件 中的描述,在 已安装 选项卡的 Plugins 页面上启用它们。

选择此选项以配置对在 Docker 容器中运行的 PHP 解释器的访问。 在对话框的字段中,指定以下内容:

  • 服务器 字段中,指定要使用的 Docker 配置。 有关更多信息,请参阅 配置 Docker 守护程序连接设置。 从列表中选择一个配置,或单击 新建... 并在打开的 Docker 页面上创建一个新配置。

  • 镜像名称 字段中,指定要使用的基础 Docker 镜像。 从列表中选择一个先前下载的或自定义的图像,或者手动输入图像名称,例如, php:latestphp:7.0-cli。 当您稍后启动运行配置时,Docker 将在您的机器上搜索指定的镜像。 如果搜索失败,镜像将从 Docker 官方镜像 仓库下载到 Docker Registry 页面

Docker Compose

仅当启用了 PHP DockerDocker插件时,此选项才可用。 这些插件默认是激活的。 如果插件被禁用,请按照 安装插件 中的描述,在 已安装 选项卡的 Plugins 页面上启用它们。

选择此选项以配置对在多容器应用程序中运行的 Docker 容器中的 PHP 解释器的访问。 在对话框的字段中,指定以下内容:

PHP 解释器路径

在此字段中,根据所选远程开发环境的配置,指定 PHP可执行文件的位置。

  • 对于远程主机,PhpStorm 默认建议 /usr/bin/php 位置。

  • 对于 Vagrant 实例,PhpStorm 默认建议 /usr/bin/php 位置。

  • 对于 Docker 容器,PhpStorm 默认建议 php 位置。

若要指定不同的文件夹,请点击 打开 并在打开的对话框中选择相关文件夹。 请注意,PHP 主目录必须可编辑。

当您单击 确定 时,PhpStorm 会检查 PHP 可执行文件是否确实存储在指定的文件夹中。

  • 如果未找到 PHP 可执行文件,PhpStorm 会显示一条错误消息,询问您是否继续搜索或仍然保存解释器配置。

    未找到 PHP 执行文件
  • 如果找到 PHP 可执行文件,您将返回到 解释器 对话框,其中显示了安装文件夹和检测到的 PHP 解释器版本。

Vagrant

仅当安装并启用了 Vagrant存储库插件时,此选项才可用。 Vagrant 插件未与 PhpStorm 捆绑,但可以在 设置 | 插件 页面、选项卡 插件市场 上安装,如 从 JetBrains Marketplace 安装插件 中所述。

选择此选项以使用您的 Vagrant凭据配置对安装在 Vagrant 实例中的 PHP 解释器的访问。 从技术上讲,这是用于所需环境的 VagrantFile 配置文件所在的文件夹。 基于此设置,PhpStorm 检测到 Vagrant host 并将其作为链接显示在 Vagrant 主机 URL 只读字段中。

要使用解释器配置,您需要 路径映射 ,以设置项目文件夹、服务器上用于复制项目文件的文件夹以及访问服务器上复制数据的 URL 地址之间的对应关系。 PhpStorm 从 VagrantFile 配置文件中评估路径映射。

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