配置远程 PHP 解释器
远程 PHP 解释器 是安装在远程主机或虚拟环境中的 PHP 引擎。 术语 远程 PHP 解释器 与安装在本地计算机上的 本地 PHP 解释器 相对。
在 PhpStorm 中，您可以通过 SSH、Docker 容器、Docker Compose、Vagrant 或 WSL 配置对远程 PHP 解释器的访问：
通过使用 SSH 配置类型，您可以访问安装在远程主机服务器上的 PHP 解释器。
使用 SSH 配置 PHP 解释器
按 Ctrl+Alt+S 打开设置，然后选择 。
在打开的 PHP 页面上，单击
，位于 CLI 解释器 列表旁边。在打开的 CLI 解释器 对话框中，单击左侧窗格中的
，然后从弹出菜单中选择 来自 Docker、Vagrant、VM、WSL、远程...。 
在打开的 配置远程 PHP 解释器 对话框中，选择 SSH 方法并按如下方式填写方法参数：
字段
描述
SSH 配置
从列表中选择一个已创建的 SSH 配置，或者单击
并按照 创建 SSH 配置 中的描述创建一个新配置。PHP 解释器路径
根据所选远程开发环境的配置，指定 PHP 可执行文件的位置。
对于远程主机，PhpStorm 默认建议 /usr/bin/php 位置。
若要指定不同的文件夹，请点击
并在打开的对话框中选择相关文件夹。 请注意，PHP 主目录必须可编辑。点击 确定。 PhpStorm 会检查是否在 PHP 解释器路径 字段中指定的文件夹中实际存储了 PHP 可执行文件。
如果未找到 PHP 可执行文件，PhpStorm 会显示一条错误消息，询问您是否继续搜索或仍然保存解释器配置。
如果找到 PHP 可执行文件，您将返回到 CLI 解释器 对话框，其中显示了安装文件夹和检测到的 PHP 解释器版本。
单击
，位于 PHP 可执行文件 字段旁边，会打开一个单独的信息窗口，其中包含安装详细信息以及已加载的扩展和配置选项的列表。单击 Apply 和 确定 保存更改并返回到 PHP 设置页面。
除了 CLI 解释器 字段中配置的远程 PHP 解释器外， PHP 设置页面现在还会显示一个只读的 路径映射 字段。
路径映射用于设置项目文件夹、服务器上用于复制项目文件的文件夹以及用于访问服务器上复制数据的 URL 地址之间的对应关系。
PhpStorm 首先尝试通过处理所有可用的应用程序级配置来自行检索路径映射。 如果 PhpStorm 找到与所选 SSH 配置中指定的主机相同的配置，则这些配置的映射会自动合并。
如果未找到包含此主机的配置，PhpStorm 会显示一条错误消息，通知您路径映射未配置。
单击
，位于 路径映射 字段中，并手动将本地文件夹映射到服务器上的文件夹。 详情请参见 配置自定义映射。
通过使用 Docker 配置类型，您可以访问安装在 Docker 容器中的 PHP 解释器。
在 Docker 容器中配置 PHP 解释器
按 Ctrl+Alt+S 打开设置，然后选择 。
在打开的 PHP 页面上，单击
，位于 CLI 解释器 列表旁边。在打开的 CLI 解释器 对话框中，单击左侧窗格中的
，然后从弹出菜单中选择 来自 Docker、Vagrant、VM、WSL、远程...。在打开的 配置远程 PHP 解释器 对话框中，选择 Docker 方法并提供连接参数：
字段
描述
服务器
指定要使用的 Docker 配置。 有关更多信息，请参阅 配置 Docker 守护程序连接设置。 从列表中选择一个配置，或单击 新建... 并在打开的 Docker 页面上创建一个新配置。
镜像名称
指定要使用的基础 Docker 镜像。 从列表中选择一个先前下载的或自定义的图像，或者手动输入图像名称，例如，
php:latest或php:7.0-cli。 当您稍后启动运行配置时，Docker 将在您的机器上搜索指定的镜像。 如果搜索失败，镜像将从 Docker 官方镜像 仓库下载到 Docker Registry 页面。PHP 解释器路径
根据所选远程开发环境的配置，指定 PHP 可执行文件的位置。
对于 Docker 容器，PhpStorm 默认建议 php 位置。
点击 确定。 PhpStorm 会检查是否在 PHP 解释器路径 字段中指定的文件夹中实际存储了 PHP 可执行文件。
如果未找到 PHP 可执行文件，PhpStorm 会显示一条错误消息，询问您是否继续搜索或仍然保存解释器配置。
如果找到 PHP 可执行文件，您将返回到 CLI 解释器 对话框，其中显示了安装文件夹和检测到的 PHP 解释器版本。
单击
，位于 PHP 可执行文件 字段旁边，会打开一个单独的信息窗口，其中包含安装详细信息以及已加载的扩展和配置选项的列表。单击 Apply 和 确定 保存更改并返回到 PHP 设置页面。
除了 CLI 解释器 字段中配置的远程 PHP 解释器外， PHP 设置页面现在还会显示只读的 路径映射 和 Docker 容器 字段。
PhpStorm 尝试通过处理所有可用的应用程序级配置来自动检索路径映射。 要设置自定义路径映射，请单击
，位于 路径映射 字段中，并手动将本地文件夹映射到服务器上的文件夹。 详情请参见 配置自定义映射。
通过使用 Docker Compose 配置，您可以访问运行在多容器 Docker Compose 环境中的 PHP 解释器。
使用 Docker Compose 配置 PHP 解释器
按 Ctrl+Alt+S 打开设置，然后选择 。
在打开的 PHP 页面上，单击
，位于 CLI 解释器 列表旁边。在打开的 CLI 解释器 对话框中，单击左侧窗格中的
，然后从弹出菜单中选择 来自 Docker、Vagrant、VM、WSL、远程...。在打开的 配置远程 PHP 解释器 对话框中，选择 Docker Compose 方法并提供连接参数：
字段
描述
服务器
指定要使用的 Docker 配置。 有关更多信息，请参阅 配置 Docker 守护程序连接设置。 从列表中选择一个配置，或单击 新建... 并在打开的 Docker 页面上创建一个新配置。
配置文件
指定要使用的 docker-compose 配置文件。 默认情况下，位于项目根目录的基础配置文件会被选中。 要选择不同的文件或多个文件，请单击
，并在打开的 Docker Compose 配置文件 对话框中选择所需的配置文件。服务
选择与设置 PHP 开发环境的容器相对应的服务。
环境变量
可选地，提供 环境变量。 有关更多信息，请参阅 Docker Compose run configuration设置。
PHP 解释器路径
根据所选远程开发环境的配置，指定 PHP 可执行文件的位置。
对于 Docker 容器，PhpStorm 默认建议 php 位置。
点击 确定。 PhpStorm 会检查是否在 PHP 解释器路径 字段中指定的文件夹中实际存储了 PHP 可执行文件。
如果未找到 PHP 可执行文件，PhpStorm 会显示一条错误消息，询问您是否继续搜索或仍然保存解释器配置。
如果找到 PHP 可执行文件，您将返回到 CLI 解释器 对话框，其中显示了安装文件夹和检测到的 PHP 解释器版本。
单击
，位于 PHP 可执行文件 字段旁边，会打开一个单独的信息窗口，其中包含安装详细信息以及已加载的扩展和配置选项的列表。在 生存期 区域的 CLI 解释器 对话框中，选择 PhpStorm 应如何管理所选服务的 Docker 容器。
单击 Apply 和 确定 保存更改并返回到 PHP 设置页面。
除了 CLI 解释器 字段中配置的远程 PHP 解释器外， PHP 设置页面现在还会显示一个只读的 路径映射 字段。
PhpStorm 尝试通过处理所有可用的应用程序级配置来自动检索路径映射。 要设置自定义路径映射，请单击
，位于 路径映射 字段中，并手动将本地文件夹映射到服务器上的文件夹。 详情请参见 配置自定义映射。
通过使用 Vagrant 配置，您可以访问安装在相应 Vagrant 实例上的 PHP 解释器。
在 Vagrant 实例中配置 PHP 解释器
按 Ctrl+Alt+S 打开设置，然后选择 。
在打开的 PHP 页面上，单击
，位于 CLI 解释器 列表旁边。在打开的 CLI 解释器 对话框中，单击左侧窗格中的
，然后从弹出菜单中选择 来自 Docker、Vagrant、VM、WSL、远程...。在打开的 配置远程 PHP 解释器 对话框中，选择 Vagrant 方法并提供连接参数：
字段
描述
Vagrant 实例文件夹
指定指向您将要使用的环境的文件夹。 从技术上讲，这是用于所需环境的 VagrantFile 配置文件所在的文件夹。 基于此设置，PhpStorm 检测到 Vagrant host 并将其作为链接显示在 Vagrant 主机 URL 只读字段中。
要使用解释器配置，您需要 路径映射 ，以设置项目文件夹、服务器上用于复制项目文件的文件夹以及访问服务器上复制数据的 URL 地址之间的对应关系。 PhpStorm 从 VagrantFile 配置文件中评估路径映射。
PHP 解释器路径
根据所选远程开发环境的配置，指定 PHP 可执行文件的位置。
对于 Vagrant 实例，PhpStorm 默认建议 /usr/bin/php 位置。
若要指定不同的文件夹，请点击
并在打开的对话框中选择相关文件夹。 请注意，PHP 主目录必须可编辑。点击 确定。 PhpStorm 会检查是否在 PHP 解释器路径 字段中指定的文件夹中实际存储了 PHP 可执行文件。
如果未找到 PHP 可执行文件，PhpStorm 会显示一条错误消息，询问您是否继续搜索或仍然保存解释器配置。
如果找到 PHP 可执行文件，您将返回到 CLI 解释器 对话框，其中显示了安装文件夹和检测到的 PHP 解释器版本。
单击
，位于 PHP 可执行文件 字段旁边，会打开一个单独的信息窗口，其中包含安装详细信息以及已加载的扩展和配置选项的列表。
通过使用 WSL ，您可以通过 Windows Subsystem for Linux 兼容层访问安装在 Linux 环境中的 PHP 解释器。
使用 WSL 配置 PHP 解释器
按 Ctrl+Alt+S 打开设置，然后选择 。
在打开的 PHP 页面上，单击
，位于 CLI 解释器 列表旁边。在打开的 CLI 解释器 对话框中，单击左侧窗格中的
，然后从弹出菜单中选择 来自 Docker、Vagrant、VM、WSL、远程...。在打开的 配置远程PHP 解释器 对话框中，选择 WSL 方法并提供连接参数：
字段
描述
Linux 发行版(D)
从下拉列表中选择要使用的已安装 Linux 发行版之一。
PHP 解释器路径
根据所选远程开发环境的配置，指定 PHP 可执行文件的位置。
对于 WSL，PhpStorm 默认建议 /usr/local/bin/php 。
若要指定不同的文件夹，请点击
并在打开的对话框中选择相关文件夹。 请注意，PHP 主目录必须可编辑。点击 确定。 PhpStorm 会检查是否在 PHP 解释器路径 字段中指定的文件夹中实际存储了 PHP 可执行文件。
如果未找到 PHP 可执行文件，PhpStorm 会显示一条错误消息，询问您是否继续搜索或仍然保存解释器配置。
如果找到 PHP 可执行文件，您将返回到 CLI 解释器 对话框，其中显示了安装文件夹和检测到的 PHP 解释器版本。
单击
，位于 PHP 可执行文件 字段旁边，会打开一个单独的信息窗口，其中包含安装详细信息以及已加载的扩展和配置选项的列表。
提供额外的配置选项
按 Ctrl+Alt+S 打开设置，然后选择 。
在打开的 PHP 页面上，单击
，位于 CLI 解释器 列表旁边。在 其他 区域的 CLI 解释器 对话框中自定义 PHP 安装的配置设置。
字段
描述
调试器扩展
指定用于调试的 Xdebug 可执行文件的路径，位于 按需模式 中。 通过这种方式，即使在 php.ini 文件中禁用了 Xdebug，PhpStorm 也可以激活它。
配置选项
组合一串配置指令，通过 -d 命令行选项 传递，从而向 php.ini 文件添加新条目。 此字段中指定的指令会覆盖 PhpStorm 生成的默认指令，例如：
-dxdebug.mode=debug, -dxdebug.client_host=127.0.0.1, -dxdebug.client_port=9003, -dxdebug.start_upon_error=default例如，如果您指定了
-dxdebug.start_upon_error=yes指令，它将覆盖默认的-dxdebug.start_upon_error=default指令，从而将 Xdebug 切换到 即时模式 (JIT)。 欲了解更多信息，请参阅 在 Just-In-Time 模式下调试。-dxdebug.remote_enable=1, -dxdebug.remote_host=127.0.0.1, -dxdebug.remote_port=9000, -dxdebug.remote_mode=req例如，如果您指定了
-dxdebug.remote_mode=jit指令，它将覆盖默认的-dxdebug.remote_mode=req指令，从而将 Xdebug 切换到 即时模式 (JIT)。 欲了解更多信息，请参阅 在 Just-In-Time 模式下调试。为此，请单击
，位于 配置选项 字段旁边，然后在打开的 配置选项 对话框中创建一个条目列表。要添加新条目，请单击
。 在添加到列表的新行中，分别在 名称 和 Value 字段中指定新条目的名称及其值。 您可以根据需要添加任意多的条目，但请记住，它们将被转换为命令行，其长度限制为 256 个字符。
要删除条目，请在列表中选择它并单击
。要更改条目的顺序，请单击
或 
。
单击 确定 后，您将返回到 CLI 解释器 对话框，其中条目将被转换为命令行。
配置自定义映射
如果您使用通过 SSH 连接访问的解释器，或位于 Vagrant 实例或 Docker 容器中的解释器，则映射会从相应的部署配置、 Vagrantfile 或 Dockerfile 中自动检索。
按 Ctrl+Alt+S 打开设置，然后选择 。
从 解释器 列表中选择要为其自定义映射的远程解释器。 路径映射 只读字段显示从相应的部署配置、 Vagrantfile 或 Dockerfile 中检索的路径映射。 要指定自定义映射，请单击
，位于 路径映射 字段旁边。编辑项目路径映射 对话框显示从部署配置、 Vagrantfile 或 Dockerfile 中检索的路径映射。 这些映射是只读的。
要添加自定义映射，请点击
，并在 本地路径 和 远程路径 字段中分别指定项目中的路径和远程运行环境中的相应路径。 请手动输入路径或点击 ，在打开的对话框中选择相关的文件或文件夹。要删除自定义映射，请在列表中选择它，然后点击
。
在配置的 PHP 解释器之间即时切换
按 Ctrl+Shift+A 并开始输入
Change PHP interpreter。 在建议列表中，选择 Change PHP interpreter 操作。如果需要，您可以直接在建议列表中按 Alt+Enter 为此操作分配键盘快捷键，或者稍后按照 键盘快捷键 中的说明进行分配。
所选解释器将被设置为 设置 对话框 Ctrl+Alt+S 页面的默认项目解释器 PHP。 这也会影响使用默认项目解释器的配置（测试框架、 质量工具 和 运行/调试配置 ）以及在 PhpStorm 终端 中运行的命令。
