Behat

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

使用此对话框创建一个配置，用于在 PHP 应用程序上运行和调试单元测试，使用 Behat 框架。

开始之前

要运行 Behat 测试：

按照 Behat 中的描述，在您的计算机上安装并配置 Behat 框架。
确保已启用 PHP 和 Behat 插件。这些插件默认是激活的。如果插件被禁用，请按照安装插件中的描述，在已安装选项卡的 Plugins 页面上启用它们。

测试运行器区域

在此区域中，指定要启动的场景以及要传递给 Behat 的命令行开关。

项目	描述
测试范围	在此区域中，指定场景的位置或列出它们的配置文件。目录：选择此选项以启动目录中的所有场景。在目录字段中，指定要搜索包含场景的 .feature 文件的目录。手动输入目录路径，或单击浏览并在打开的选择测试目录对话框中选择所需的目录。 File: 选择此选项以启动特定 .feature 文件中的所有场景。在 File 字段中，指定要搜索场景的 .feature 文件。手动输入文件路径，或单击浏览并在打开的对话框中选择所需的目录。在类字段中，指定所需的类。手动输入类名或单击浏览，然后在打开的树视图中选择所需的类。场景：选择此选项以启动特定场景。在 File 字段中，指定要搜索场景的 .feature 文件。手动输入文件名或单击浏览，然后在打开的树视图中选择所需的文件。在 Scenario 字段中，指定所需的场景。在配置文件中定义：选择此选项以让 Behat 从专用的 .yml 配置文件中执行测试。默认情况下， Behat 使用在测试运行器区域的测试框架页面中指定的配置文件。反之，这可以是原生配置文件（ behat.yml 或 config/behat.yml ），也可以是您在 PhpStorm 中初始配置 Behat 时指定为 Default 的任何其他 YML 配置文件。要使用所有 Behat 运行配置的默认文件，请清除使用替代配置文件复选框。要从自定义配置文件中启动场景，请选中使用替代配置文件复选框，并在旁边的字段中指定所需 YML 文件的位置。要打开 Behat 页面并指定另一个默认配置文件以供使用，请单击按钮。

项目

描述

测试范围

在此区域中，指定场景的位置或列出它们的配置文件。

目录：选择此选项以启动目录中的所有场景。
在目录字段中，指定要搜索包含场景的 .feature 文件的目录。手动输入目录路径，或单击浏览并在打开的选择测试目录对话框中选择所需的目录。
File: 选择此选项以启动特定 .feature 文件中的所有场景。
1. 在 File 字段中，指定要搜索场景的 .feature 文件。手动输入文件路径，或单击浏览并在打开的对话框中选择所需的目录。
2. 在类字段中，指定所需的类。手动输入类名或单击浏览，然后在打开的树视图中选择所需的类。
场景：选择此选项以启动特定场景。
1. 在 File 字段中，指定要搜索场景的 .feature 文件。手动输入文件名或单击浏览，然后在打开的树视图中选择所需的文件。
2. 在 Scenario 字段中，指定所需的场景。
在配置文件中定义：选择此选项以让 Behat 从专用的 .yml 配置文件中执行测试。
默认情况下， Behat 使用在测试运行器区域的测试框架页面中指定的配置文件。反之，这可以是原生配置文件（ behat.yml 或 config/behat.yml ），也可以是您在 PhpStorm 中初始配置 Behat 时指定为 Default 的任何其他 YML 配置文件。
- 要使用所有 Behat 运行配置的默认文件，请清除使用替代配置文件复选框。
- 要从自定义配置文件中启动场景，请选中使用替代配置文件复选框，并在旁边的字段中指定所需 YML 文件的位置。
- 要打开 Behat 页面并指定另一个默认配置文件以供使用，请单击按钮。

命令行区域

在此区域，选择一个 PHP 解释器，并通过指定要传递给 PHP 可执行文件的选项和参数来自定义其行为。

项目	描述
解释器	该列表包含所有当前配置的本地和远程 PHP 解释器。从列表中选择一个已配置的 PHP 解释器，或单击并按照配置本地 PHP 解释器和配置远程 PHP 解释器中的描述定义一个新的解释器。
解释器选项	在此字段中，指定要传递给 PHP 可执行文件的选项。它们会覆盖 PHP 解释器的默认行为或确保执行额外的操作。如有必要，单击并在命令行选项对话框中输入所需的选项。每行输入一个选项。关闭对话框后，所有选项将以空格分隔的形式显示在命令行选项字段中。
自定义工作目录	在此字段中，指定测试文件夹外部文件的位置，这些文件通过相对路径在您的测试中被引用。此设置不会阻止测试执行，因为测试的位置始终通过对应文件和目录的完整路径指定。默认情况下，该字段为空，工作目录为项目的根目录。
环境变量	在此字段中，指定要传递给内置服务器的环境变量。您可以通过单击手动添加环境变量的名称-值对，或单击并浏览到计算机上的 `.env` 文件。有关更多信息，请参阅 Apache 中的环境变量。

Docker Compose 区域

仅当您在解释器字段中选择基于 Docker Compose 的远程解释器时，此区域才会显示。在这里，您可以向运行配置中添加一些带选项的 Docker Compose 命令。

项目

描述

命令和选项

您可以使用 Docker Compose 命令行界面的以下命令：

命令	支持的选项
up ：为服务构建、创建、启动并附加到容器。	`--abort-on-container-exit` `--构建` `--exit-code-from SERVICE` `--scale SERVICE=NUM...` `--timeout TIMEOUT`
run ：针对服务运行一次性命令。	`--entrypoint CMD` `-l, --label KEY=VAL` `--name NAME` `-p, --publish=[]` `--rm` `--service-ports` `--use-aliases` `-u, --user=""` `-v, --volume=[]`
exec ：在您的服务中运行任意命令。	`--index=index` `--privileged` `-u, --user USER`

命令预览

使用此字段预览完整的命令字符串。

例如， up --build exec --user jetbrains 和命令和选项字段中的组合会在预览中生成以下输出：

通用设置

当您编辑运行配置（而不是运行配置模板）时，您可以指定以下选项：

项目	描述
名称	为运行配置指定一个名称，以便在编辑或运行时能快速识别。
允许多个实例	允许并行运行多个此运行配置实例。默认情况下，它是禁用的，当您在另一个实例仍在运行时启动此配置时，PhpStorm建议停止正在运行的实例并启动另一个实例。这在运行配置消耗大量资源且没有充分理由运行多个实例时非常有用。
存储为项目文件	将运行配置设置保存到文件中，以便与其他团队成员共享。默认位置是 .idea/runConfigurations 。但是，如果您不想共享 .idea 目录，您可以将配置保存到项目中的任何其他目录。默认情况下，它是禁用的，并且 PhpStorm 将运行配置设置存储在 .idea/workspace.xml 。

项目

描述

名称

为运行配置指定一个名称，以便在编辑或运行时能快速识别。

允许多个实例

允许并行运行多个此运行配置实例。

默认情况下，它是禁用的，当您在另一个实例仍在运行时启动此配置时，PhpStorm建议停止正在运行的实例并启动另一个实例。这在运行配置消耗大量资源且没有充分理由运行多个实例时非常有用。

存储为项目文件

将运行配置设置保存到文件中，以便与其他团队成员共享。默认位置是 .idea/runConfigurations 。但是，如果您不想共享 .idea 目录，您可以将配置保存到项目中的任何其他目录。

默认情况下，它是禁用的，并且 PhpStorm 将运行配置设置存储在 .idea/workspace.xml 。

启动前

在此区域，您可以指定在启动所选运行/调试配置之前要执行的任务。任务按照它们在列表中出现的顺序执行。

项目	快捷方式	描述
	`Alt+Insert`	点击此图标以添加下列可用任务之一：启动 web 浏览器：选择此选项即可启动浏览器。在打开的对话框中，选择浏览器的类型并提供起始 URL。此外，指定是否希望浏览器以启用 JavaScript 调试器的方式启动。运行 External tool ：选择运行外部应用程序。在打开的对话框中，选择您要运行的一个或多个应用程序。如果在 PhpStorm 中尚未定义，请添加其定义。如需更多信息，请参阅外部工具和外部工具。运行另一个配置：选择执行另一个运行/调试配置，并等待其完成后再开始当前配置。如果您想并行运行多个配置，请使用 compound run/debug configuration。运行 File Watchers ：选择此选项以让 PhpStorm 应用所有当前活动的文件监视器。运行远程外部工具：添加一个远程 SSH 外部工具。运行 Grunt 任务：选择此选项来运行 Grunt 任务。在打开的 Grunt 任务对话框中，指定定义所需任务的 Gruntfile.js ，选择要执行的任务，并指定传递给 Grunt 工具的参数。指定 Node.js 解释器的位置、传递给它的参数以及 grunt-cli 包的路径。运行 Gulp 任务：选择此选项以运行 Gulp task。在打开的 Gulp 任务对话框中，指定定义所需任务的 Gulpfile.js ，选择要执行的任务，并指定要传递给 Gulp 工具的参数。指定 Node.js 运行时的位置、要传递给它的参数，以及 gulp 包的路径。运行 npm 脚本：选择此选项来执行一个 npm 脚本。在 NPM Script 对话框中，指定 npm run/debug configuration settings。编译 TypeScript ：选择运行内置的 TypeScript 编译器，从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。在打开的 TypeScript 编译设置对话框中，选择或清除此检查错误复选框，以配置编译器在检测到错误时的行为: 如果选中了检查错误复选框，编译器会显示所有错误，并且运行配置将不会启动。如果清除了检查错误复选框，编译器将显示所有检测到的错误，但运行配置仍将启动。生成 CoffeeScript 源映射：选择此选项以生成 CoffeeScript 源代码的源映射。在打开的对话框中，指定您的 CoffeeScript 源文件所在的位置。上传文件到远程主机：选择此选项以根据默认服务器访问配置自动上传应用程序文件到服务器。
	`Alt+Delete`	点击此图标可将所选任务从列表中移除。
	`Enter`	点击此图标可编辑选定的任务。请在打开的对话框中进行必要的更改。
	`Alt+Up` `Alt+Down`	点击这些图标以在列表中将所选任务上移或下移一行。任务将按照它们在列表中出现的顺序执行。
显示此页面		选择此复选框，以便在实际启动运行/调试配置之前显示运行/调试配置设置。
激活工具窗口		默认情况下，此复选框处于选中状态，并且在您启动 run/debug 配置时， Run 或 Debug 工具窗口会打开。否则，如果复选框未选中，工具窗口将被隐藏。但是，在配置运行时，您可以通过按 `Alt+4` 或 `Alt+5` 自行打开相应的工具窗口。
聚焦工具窗口.		选中此复选框以在您开始运行/调试配置时，自动将焦点移动到运行或调试工具窗口。

日志

以下选项与记录此配置的执行相关。有关更多信息，请参见。

项目	描述
指定要在控制台中显示的日志	指定在运行应用程序时显示哪些日志文件。点击添加新日志。在编辑日志文件别名对话框中，配置以下内容：别名：日志将显示的选项卡名称。日志文件位置：指定日志文件的路径或 Ant 模式。如果多个滚动日志文件匹配该模式，PhpStorm 将显示最新的一个。显示所有可由模式匹配的文件：显示所有匹配该模式的日志。对于表格中的日志，您可以配置以下选项：是否激活：显示指定的日志文件。跳过内容：不显示先前运行的旧日志消息。
将控制台输出保存到文件	将控制台输出保存到指定位置。手动输入路径，或点击浏览按钮，然后在打开的对话框中指向所需位置。
有消息打印到 stdout 时显示控制台	当应用程序写入标准输出流时激活控制台。
有消息打印到 stderr 时显示控制台	当应用程序写入标准错误流时激活控制台。

2026年 7月 14日