PhpStorm 2025.2 Help

CLI 解释器

当您单击 “浏览”按钮 位于 CLI 解释器 列表旁边的 开发环境 部分的 PHP 页面时,将打开此对话框。

使用此对话框将 PHP 引擎配置为 解释器 ,请参阅 配置本地 PHP 解释器配置远程 PHP 解释器。 在此对话框中,您可以添加新的解释器,编辑或删除现有的解释器。

该对话框由两个窗格组成。 左侧窗格列出了所有已配置的 PHP 解释器,包括本地和远程的,并包含一个工具栏,用于添加、删除和复制 PHP 解释器配置。 右侧窗格的内容取决于左侧窗格中当前选定的解释器类型。 使用此窗格中的控件编辑所选解释器的设置,甚至在必要时选择其类型。

左侧窗格

左侧窗格列出了所有已配置的 PHP 解释器,包括本地和远程的,并包含一个工具栏,用于添加、删除和复制 PHP 解释器配置。

项目

提示

描述

"添加"按钮

Add

单击此按钮将新的 PHP 解释器添加到列表中。 从弹出列表中选择解释器类型(本地远程 ),并在右侧窗格中配置本地解释器,或在打开的 配置 PHP 远程解释器对话框 对话框中配置远程解释器。

"移除"按钮

删除

点击此按钮从列表中删除所选的解释器。

复制按钮

复制

点击此按钮以创建一个具有从所选解释器复制设置的新解释器。

右侧窗格

右侧窗格的内容取决于左侧窗格中当前选定的解释器类型。 使用此窗格中的控件编辑所选解释器的设置,甚至在必要时选择其类型。

通过 SSH 访问的远程解释器

项目

描述

SSH 配置(S)

从此列表中,选择已创建的 SSH 配置之一,或单击 “浏览”按钮 并按照 创建 SSH 配置 中的描述创建新配置。

Vagrant 实例上的远程解释器

项目

描述

Vagrant 实例文件夹

在此字段中,选择指向您将要使用的环境的文件夹。 从技术上讲,这是用于所需环境的 VagrantFile 配置文件所在的文件夹。 基于此设置,PhpStorm 检测到 Vagrant host 并将其作为链接显示在 Vagrant 主机 URL 只读字段中。

Docker 容器中的远程解释器

项目

描述

服务器

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

镜像名称

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

运行在多容器 Docker Compose 应用程序中的远程解释器

项目

描述

服务器

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

配置文件

在此字段中,指定定义应用程序服务的 docker-compose.yml 文件

服务

在此字段中,选择所需的应用程序服务。

环境变量

在此字段中,定义环境变量。 有关更多信息,请参阅 Docker Compose run configuration设置。

生命周期

在此区域中,选择 PhpStorm 应如何管理所选服务的 Docker 容器。

  • 始终启动一个新容器('Docker-compose run') :选择此选项以通过 run 命令启动容器。 容器将在每次运行时重新启动。

  • 连接到现有容器('Docker-compose exec') :选择此选项以启动容器一次,然后通过 exec 命令连接到它。

通过 Windows Subsystem for Linux (WSL) 运行的远程解释器

项目

描述

Linux 发行版

从此列表中选择一个已安装的 Linux 发行版以使用。

常规区域

项目

描述

名称

在此字段中,输入标识符以区分此解释器与其他解释器,例如 php_installation_<version>

PHP 可执行文件

在此字段中,指定 PHP 引擎的路径。 手动输入路径或单击 打开 并在打开的对话框中选择可执行文件。 PhpStorm 检测到 PHP 的版本并将其显示在 PHP 版本 只读字段中。

PhpStorm 还会检测调试引擎和 php.ini 配置文件。 与 PHP 解释器关联的调试引擎类型及其版本显示在 调试器 只读字段中。 如果未检测到调试器,或者您在 php.ini 文件中禁用了它(请参阅 配置 Xdebug 以在按需模式中使用 ),该字段将显示 调试器:未安装

php.ini 的位置显示在 配置文件 只读字段中。 要在 PhpStorm 中编辑 php.ini ,请单击 在编辑器中打开

重新加载

重新加载 phpinfo 按钮

单击此按钮以检查指定的 PHP 主目录是否确实包含 PHP 可执行文件。 如果在指定位置未检测到 PHP 可执行文件,PhpStorm 将显示相应的错误消息。

显示 phpinfo

显示 phpinfo 按钮

单击此按钮会打开一个单独的信息窗口,其中包含安装详细信息以及已加载扩展和配置选项的列表。

高级区域

项目

描述

调试器扩展

在此字段中,指定 Xdebug 扩展的位置,以便 PhpStorm 在必要时激活它。

PhpStorm 支持 按需 模式,您可以为全局 PHP 安装禁用调试器,并仅在调试命令行脚本或需要代码覆盖率报告时按需自动启用它。 这使得您的命令行脚本(包括 Composer 和单元测试)运行速度更快。

配置选项

使用此字段通过组合配置指令字符串来自定义安装的配置设置,这些指令将通过 -d 命令行选项 传递,从而向 php.ini 文件添加新条目。 单击 打开 打开 配置选项 对话框,并在其中创建新 php.ini 条目的列表。

配置选项对话框

项目

工具提示和快捷键

描述

名称

在此字段中,输入新条目的名称。

Value

在此字段中,输入新条目的值。

新建

Add

Alt+Insert

单击此按钮以在列表中添加新行,并在其中指定新条目的名称和值。

"移除"按钮

移除

Alt+Delete

点击此按钮以从列表中删除选定的条目。

“上移”按钮 “下移”按钮

上 / 下

Alt+Up &#xa0;/&#xa0; Alt+Down

使用这些按钮在列表中上移或下移所选条目。 列表中条目的顺序决定了它们通过 -d 命令行选项 传递的顺序。

您可以根据需要添加任意多的条目,但请记住,它们将被转换为命令行,其长度限制为 256 个字符。

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