PHPUnit

测试范围

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

• 目录 ：选择此选项以启动目录中的所有单元测试。

  在 目录 字段中，指定要搜索单元测试的目录。 手动输入目录路径或单击 ，然后在打开的 选择测试目录 对话框中选择所需的目录。

• 类 ：选择此选项以启动测试类中的所有单元测试。

  在 类 字段中，输入所需类的名称。 要快速定位类，请使用代码补全 Ctrl+Space。 所选类的位置将显示在控件 File 只读字段中。

• 方法 ：选择此选项以启动特定的测试方法。

  在 类 字段中，输入所需类的名称。 要快速定位类，请使用代码补全 Ctrl+Space。 所选类的位置将显示在控件 File 只读字段中。

  在 方法 字段中，指定所需的方法。 要快速定位类，请使用代码补全 Ctrl+Space。

• 在配置文件中定义 ：选择此选项以让测试运行器从专用的 XML 配置文件中执行测试。

• 复合 ：选择此选项以让测试运行器从任意测试选择中执行测试。

  在 复合测试模式 区域中，使用 、 和 管理要包含在配置中的测试模式（即测试类或测试方法）列表。

  要添加测试模式，请单击 。 要编辑现有模式，请单击 。 在打开的 添加 PHPUnit 测试模式 对话框中，通过使用 按名称搜索 选项卡或 Project 选项卡定位所需的测试类或测试方法符号。 如果所选测试方法使用数据提供者，请在 数据集 字段中提供数据集的名称。 请注意，对于多个数据集，您需要为每个数据集创建一个单独的模式条目。

  默认情况下，PhpStorm 会根据您的项目结构自动检测测试模式的位置。 要明确指定包含测试模式的目录，请选中 使用替代模式基路径 复选框，然后单击 并在打开的对话框中定位所需的目录。

使用替代配置文件

在此字段中，选择 PHPUnit 配置文件的位置。

• 要使用在 测试框架 页面的 设置 对话框（Ctrl+Alt+S ）中指定的默认配置文件，请清除 使用替代配置文件 复选框。 如果在 测试框架 页面上未指定默认配置文件，则运行/调试配置无效。 要快速打开 测试框架 页面，请单击 。

• 要从自定义配置文件运行测试，请选中 使用替代配置文件 复选框，单击 ，并指定要使用的文件位置。

使用备用引导文件

在此字段中，选择将在启动测试之前执行的引导 PHP 脚本的位置。

• 要使用在 测试框架 页面的 设置 对话框（Ctrl+Alt+S ）中指定的默认引导文件，请清除 使用备用引导文件 复选框。

• 要执行自定义引导文件，请选中 使用备用引导文件 复选框，单击 ，并指定要使用的文件位置。

测试运行器选项

在此字段中，指定 测试运行器开关。

如有必要，单击 并在 命令行选项 对话框中输入所需的开关。 每行输入一个开关。 关闭对话框时，指定的开关将以空格为分隔符显示在 测试运行器选项 字段中。

首选覆盖引擎

从此列表中选择一个已配置的代码覆盖运行器：

• Xdebug ，一种调试扩展，提供 调试和代码覆盖功能。

  要启用 Xdebug，请确保在活动的 php.ini 文件的 [xdebug] 部分中至少指定以下设置。

  [xdebug] zend_extension="<path to xdebug extension>" xdebug.mode=coverage

  [xdebug] zend_extension="<path to xdebug extension>" xdebug.coverage_enable=1

  有关更多信息，请参见 配置 Xdebug。

• PCOV ，一种轻量级扩展，仅提供代码覆盖功能。

  要启用 PCOV，请按照 PCOV 文档中的说明下载并安装扩展。 然后，请确保在活动的 php.ini 文件中至少指定以下设置：

  extension="<path to pcov extension>"

• phpdbg ，一种调试和代码覆盖模块，捆绑在 PHP 5.6 及更高版本中，无需额外配置。

解释器

该列表包含所有当前配置的本地和远程 PHP 解释器。 从列表中选择一个已配置的 PHP 解释器，或单击 并按照 配置本地 PHP 解释器 和 配置远程 PHP 解释器 中的描述定义一个新的解释器。

解释器选项

在此字段中，指定要传递给 PHP 可执行文件的 选项。 它们会覆盖 PHP 解释器的默认行为或确保执行额外的操作。

如有必要，单击 并在 命令行选项 对话框中输入所需的选项。 每行输入一个选项。 关闭对话框后，所有选项将以空格分隔的形式显示在 命令行选项 字段中。

自定义工作目录

在此字段中，指定测试文件夹外部文件的位置，这些文件通过相对路径在您的测试中被引用。

此设置不会阻止测试执行，因为测试的位置始终通过对应文件和目录的完整路径指定。

默认情况下，该字段为空，工作目录为项目的根目录。

环境变量

在此字段中，指定要传递给内置服务器的 环境变量。 您可以通过单击 手动添加环境变量的名称-值对，或单击 并浏览到计算机上的 .env 文件。

有关更多信息，请参阅 Apache 中的环境变量。

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 时显示控制台

当应用程序写入标准错误流时激活控制台。