PhpStorm 2021.3 Help

CLI 解释器

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

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

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

左侧窗格

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

物品

工具提示

描述

添加按钮

添加

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

删除按钮

删除

单击此按钮可从列表中删除选定的解释器。

复制按钮

复制

单击此按钮可使用从所选解释器复制的设置创建一个新解释器。

右侧窗格

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

可通过 SSH 访问的远程解释器

SSH 配置

从此列表中,选择一个已创建的 SSH 配置,或单击浏览按钮并创建一个新配置,如创建 SSH 配置中所述。

Vagrant 实例上的远程解释器

Vagrant 实例文件夹

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

Docker 容器中的远程解释器

服务器

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

图片名称

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

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

服务器

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

配置文件

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

服务

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

环境变量

在此字段中,定义环境变量。有关详细信息,请参阅Docker 运行配置设置。

生命周期

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

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

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

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

Linux 发行版

从此列表中,选择要使用的已安装 Linux 发行版之一。

一般区域

姓名

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

PHP 可执行文件

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

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

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

重新加载

重新加载 phpinfo 按钮

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

显示phpinfo

显示 phpinfo 按钮

单击此按钮可让 PhpStorm 显示一个单独的信息窗口,其中包含安装详细信息以及加​​载的扩展和配置选项的列表。请注意,未列出在PHP 解释器对话框的配置选项字段中指定的其他选项。

高级区

调试器扩展

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

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

配置选项

使用此字段可自定义安装的配置设置,方法是编写要通过-d 命令行选项传递的配置指令字符串,从而将新条目添加到php.ini文件中。单击打开以打开“配置选项”对话框并在那里创建新的php.ini条目列表。

配置选项对话框

物品

工具提示和快捷方式

描述

姓名

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

价值

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

新的

添加

Alt+Insert

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

删除按钮

消除

Alt+Delete

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

上移按钮下移按钮

上/下

Alt+Up  /  Alt+Down

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

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

最后修改:2021 年 12 月 20 日