PhpStorm 2021.3 Help

PHPUnit

使用此对话框创建一个配置,用于在使用PHPUnit框架的控制台中运行和调试 PHP 应用程序的单元测试。

在你开始前

启用 PHPUnit 支持

  1. 在您的计算机上安装和配置PHPUnit ,请参阅PHPUnit

  2. 确保启用了PHP插件。PHP插件与PhpStorm 捆绑在一起并默认激活。如果插件被禁用,请在设置/首选项的已安装选项卡上启用它。插件页面,如管理插件中所述。

试跑者区

在此区域中,指定要启动的单元测试和要传递给测试运行器的命令行开关。

物品

描述

测试范围

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

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

    Directory字段中,指定要在其中搜索单元测试的目录。手动键入目录的路径,或者在打开的选择测试目录对话框中单击浏览按钮并选择所需的目录。

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

    字段中,输入所需类的名称。要快速定位一个类,请使用代码完成Ctrl+Space。所选类的位置将显示在控制文件只读字段中。

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

    字段中,输入所需类的名称。要快速定位一个类,请使用代码完成Ctrl+Space。所选类的位置将显示在控制文件只读字段中。

    方法字段中,指定所需的方法。要快速定位一个类,请使用代码完成Ctrl+Space

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

  • Composite:选择此选项可让测试运行程序从任意测试选择中执行测试。

    复合测试模式区域中,使用添加消除编辑按钮来管理要包含在配置中的测试模式列表(即测试类或测试方法)。

    要添加测试图案,请单击添加按钮。要编辑现有模式,请单击编辑按钮。在打开的“添加 PHPUnit 测试模式”对话框中,使用“按名称搜索”选项卡或“项目”选项卡找到所需的测试类或测试方法符号。如果所选的测试方法使用数据提供者,请在数据集字段中提供数据集的名称。请注意,在多个数据集的情况下,您需要为每个数据集创建一个单独的模式条目。

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

使用替代配置文件

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

  • 要使用设置/首选项对话框 ( ) 的测试框架页面上指定的默认配置文件,请清除使用替代配置文件复选框。如果Test Frameworks页面没有指定默认配置文件,则运行/调试配置无效。要快速打开“测试框架”页面,请单击。Ctrl+Alt+S设置按钮

  • 要从自定义配置文件运行测试,请选中使用替代配置文件复选框,单击浏览按钮,然后指定要使用的文件的位置。

使用替代引导文件

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

  • 要使用在设置/首选项对话框 ( ) 的测试框架页面上指定的默认引导文件,请清除使用替代引导文件复选框。Ctrl+Alt+S

  • 要执行自定义引导文件,请选中使用替代引导文件复选框,单击浏览按钮,然后指定要使用的文件的位置。

测试运行器选项

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

如有必要,单击并在“命令行选项”对话框扩张中键入所需的开关。在新行上键入每个开关。当您关闭对话框时,指定的开关将显示在测试运行器选项字段中,其中空格作为分隔符。

首选覆盖引擎

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

  • Xdebug,一个提供调试和代码覆盖能力的调试扩展。

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

    [xdebug] zend_extension="<xdebug 扩展的路径>" xdebug.mode=coverage
    [xdebug] zend_extension="<xdebug 扩展的路径>" xdebug.coverage_enable=1

    有关详细信息,请参阅配置 Xdebug

  • PCOV,一个只提供代码覆盖能力的轻量级扩展。

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

    extension="<pcov 扩展的路径>"
  • phpdbg,一个调试和代码覆盖模块,捆绑在 PHP 5.6 及更高版本中,不需要额外配置。

命令行区域

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

物品

描述

口译员

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

口译员选项

在此字段中,指定要传递给 PHP 可执行文件的选项。它们覆盖 PHP 解释器的默认行为或确保执行其他活动。

如有必要,单击并在“命令行选项”对话框展开按钮中键入所需的选项。在新行上键入每个选项。当您关闭对话框时,它们都显示在命令行选项字段中,并以空格作为分隔符。

自定义工作目录

在此字段中,指定包含测试的文件夹之外的文件的位置,并通过相对路径在测试中引用。

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

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

环境变量

在此字段中,指定要传递给内置服务器的环境变量。有关详细信息,请参阅Apache中的环境变量。

常用设置

当您编辑运行配置(但不是运行配置模板)时,您可以指定以下选项:

姓名

为运行/调试配置指定一个名称,以便在编辑或运行配置时快速识别它,例如,从运行弹出窗口Alt+Shift+F10中。

允许并行运行

选择以允许并行运行此运行配置的多个实例。

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

存储为项目文件

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

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

工具栏

运行/调试配置的树视图有一个工具栏,可帮助您管理项目中可用的配置以及调整默认配置模板。

物品

捷径

描述

添加按钮

Alt+Insert

创建运行/调试配置。

删除按钮

Alt+Delete

删除选定的运行/调试配置。请注意,您不能删除默认配置。

复制

Ctrl+D

创建所选运行/调试配置的副本。请注意,您会创建默认配置的副本。

保存配置

仅当您选择临时配置时才会显示该按钮。单击此按钮可将临时配置保存为永久配置。

移动到新文件夹/创建新文件夹

移动到新文件夹/创建新文件夹。您可以通过将运行/调试配置放入文件夹来对它们进行分组。

要创建文件夹,请选择类别中的配置,单击文件夹,然后指定文件夹名称。如果仅关注一个类别,则会创建一个空文件夹。

然后,要将配置移入文件夹、文件夹之间或移出文件夹,请使用拖动或提升下移按钮。

要删除分组,请选择一个文件夹并单击删除配置

排序配置

单击此按钮可按字母顺序对配置进行排序。

发射前

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

物品

捷径

描述

添加按钮

Alt+Insert

单击此图标可添加以下可用任务之一:

  • 运行外部工具:选择运行外部应用程序。在打开的对话框中,选择一个或多个要运行的应用程序。如果尚未在 PhpStorm 中定义,请添加其定义。有关详细信息,请参阅外部工具外部工具

  • 运行另一个配置:选择执行另一个运行/调试配置。在打开的对话框中,选择要运行的配置。

  • 启动 Web 浏览器:选择此选项以启动浏览器。在打开的对话框中,选择浏览器类型并提供起始 URL。此外,指定是否希望使用 JavaScript 调试器启动浏览器。

  • 运行文件观察器:选择此选项让 PhpStorm 应用所有当前活动的文件观察器。

  • 运行 Grunt 任务:选择此选项以运行 Grunt 任务。

    在打开的Grunt 任务对话框中,指定定义所需任务的Gruntfile.js,选择要执行的任务,并指定要传递给 Grunt 工具的参数。

    指定 Node.js 解释器的位置、传递给它的参数以及grunt-cli包的路径。

  • 运行 gulp 任务:选择此选项以运行 Gulp 任务。

    在打开的Gulp 任务对话框中,指定定义所需任务的Gulpfile.js,选择要执行的任务,并指定要传递给 Gulp 工具的参数。

    指定 Node.js 解释器的位置、传递给它的参数以及gulp包的路径。

  • 运行 npm 脚本:选择此选项以执行 npm 脚本。

    在打开的NPM 脚本对话框中,指定npm 运行/调试配置设置

  • 编译 TypeScript:选择运行内置的 TypeScript 编译器,从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。在打开的TypeScript 编译设置对话框中,选中或清除检查错误复选框以配置编译器在检测到任何错误时的行为:

    • 如果选中检查错误复选框,编译器将显示所有错误并且不会启动运行配置。

    • 如果检查错误复选框被清除,编译器将显示所有检测到的错误,但仍将启动运行配置。

  • 运行 Phing 目标:添加此任务以在运行或调试之前执行指定的Phing目标。要指定 Phing 目标,请单击浏览 浏览按钮并在打开的对话框中选择所需的目标。

  • 生成 CoffeeScript Source Maps:选择此选项可为您的CoffeeScript源生成源映射。在打开的对话框中,指定 CoffeeScript 源文件的位置。

  • 运行远程外部工具:添加远程 SSH 外部工具

删除按钮

Alt+Delete

单击此图标可从列表中删除选定的任务。

编辑

Enter

单击此图标可编辑选定的任务。在打开的对话框中进行必要的更改。

方法向上/方法向下

Alt+Up/Alt+Down

单击这些图标可在列表中将所选任务向上或向下移动一行。任务按照它们在列表中出现的顺序执行。

显示此页面

选中此复选框可在实际启动运行/调试配置之前显示运行/调试配置设置。

激活工具窗口

默认情况下,此复选框处于选中状态,当您启动运行/调试配置时,运行调试工具窗口将打开。

否则,如果清除该复选框,则隐藏工具窗口。但是,在配置运行时,您可以通过按Alt+4或自行为其打开相应的工具窗口Alt+5

最后修改:2021 年 8 月 27 日