测试框架
使用此页面将 PHP 测试框架与当前项目中的 PhpStorm 集成。 使用 PhpStorm,您可以运行和调试 PHPUnit、 Behat、 PHPSpec、 Codeception 和 Pest 测试。
在项目中配置测试框架
单击
并选择测试框架和 PHP 解释器以运行它:

对于远程配置,请选择已配置的 PHP 解释器之一:

在右侧窗格中,选择测试框架的来源。
对于 Behat、PHPSpec 和 Codeception,请输入框架可执行文件的路径。
对于 PHPUnit,请指定您使用的框架安装类型,可用选项为 composer 自动加载器 autoload.php 或 phpunit.phar 存档。
检查所选的远程 PHP 解释器和路径映射。
可选地,指定配置文件。 对于 PHPUnit,您还可以指定要使用的引导文件。
PHPUnit
在此窗格中,配置要与 PHP 解释器一起使用的 PHPUnit 安装。
PHPUnit 库
在此区域,指定 PHPUnit 安装的类型。 可用选项如下:
使用Composer 自动加载器 | 选择此选项以运行由 Composer 依赖管理器 安装的 PHPUnit。 该包由 autoload.php 文件从 vendor 文件夹中检索并加载。 在 脚本路径 字段中指定 autoload.php 的位置。 |
phpunit.phar 路径 | 选择此选项以从 phar 存档运行 PHPUnit。
|
测试运行器
在此区域,指定用于从 PhpStorm 启动 PHPUnit 测试的 XML 配置文件 的路径。
您还可以指定引导文件的路径,以便在启动测试前始终执行 PHP 脚本。
默认配置文件 | 选中此复选框以指定 phpunit.xml 或 phpunit.xml.dist 文件的路径,将其用作所有 PHPUnit 运行/调试配置中的默认配置文件。 请注意,您还可以在编辑特定 PHPUnit 运行/调试配置时提供备用配置文件。 如果未指定 XML 配置文件,PhpStorm 默认使用 |
默认引导文件 | 选中此复选框以便在启动测试前始终执行 PHP 脚本。 在字段中指定脚本的位置。 手动输入路径或单击 |
CLI 解释器 | 用于运行 PHPUnit 的远程 PHP CLI 解释器。 CLI 解释器 字段是只读的。 单击 |
路径映射 | 在本地源与 Vagrant 实例、Docker 容器或远程主机内的源之间的路径映射。 在大多数情况下,PhpStorm 会检测路径映射和容器设置,并自动填写所有字段。 或者,单击字段旁边的 |
Docker 容器 | 用于从镜像启动容器的 Docker 容器设置。 这些设置可能包括卷配置、暴露的端口、网络等内容。 |
PHPUnit 库
在此区域,指定 PHPUnit 安装的类型。 可用选项如下:
使用Composer 自动加载器 | 选择此选项以运行由 Composer 依赖管理器 安装的 PHPUnit。 该包由 autoload.php 文件从 vendor 文件夹中检索并加载。 在 脚本路径 字段中指定 autoload.php 的位置。 |
phpunit.phar 路径 | 选择此选项以从 phar 存档运行 PHPUnit。
|
测试运行器
在此区域,设置用于启动和执行场景的配置 XML 文件的路径。
您还可以输入引导文件的路径,以便在启动测试之前始终执行一个 PHP 脚本。 在字段中指定脚本的位置。 手动输入路径或单击 并在 打开的对话框 中选择所需的文件夹。
默认配置文件 | 选中此复选框以指定 phpunit.xml 或 phpunit.xml.dist 文件的路径,将其用作所有 PHPUnit 运行/调试配置中的默认配置文件。 请注意,您还可以在编辑特定 PHPUnit 运行/调试配置时提供备用配置文件。 如果未指定 XML 配置文件,PhpStorm 默认使用 清除复选框以让 PHPUnit 使用项目根文件夹中的 phpunit.xml 或 phpunit.xml.dist 配置文件。 如果未找到此类文件,测试执行将失败。 因此,显式指定配置文件可能更可靠。 |
默认引导文件 | 选中此复选框以便在启动测试前始终执行 PHP 脚本。 在字段中指定脚本的位置。 手动输入路径或单击 |
Behat
在此窗格中,配置通过已配置的本地和远程 PHP 解释器可用的 Behat 框架安装。
Behat 库
在此区域,指定要使用的 Behat 安装。
Behat 可执行文件路径 | 在此字段中,指定 behat.phar 存档或包含 Behat 可执行文件的文件夹的位置。 Behat 不一定需要安装在当前项目根目录下。 您可以手动输入路径或单击 |
Behat 版本发布 | 单击此链接以导航到 GitHub 上的 Behat 仓库,您可以在其中选择相关版本的 behat.phar 存档。 |
Behat 版本 | 此只读字段显示指定 Behat 安装的版本。 当您单击 刷新 图标 |
测试运行器
在此区域,设置用于启动和执行场景的配置 YML 文件的路径。
默认配置文件 | 选中此复选框以指定 YML 文件的路径,将其用作所有 Behat 运行/调试配置的默认配置文件。 清除复选框以让 Behat 使用项目根文件夹中的 behat.yml 或 behat.yml.dist 配置文件。 如果未找到此类文件,测试执行将失败。 因此,显式指定配置文件可能更可靠。 |
CLI 解释器 | 用于运行 Behat 的远程 PHP CLI 解释器。 CLI 解释器 字段是只读的。 单击 |
路径映射 | 在本地源与 Vagrant 实例、Docker 容器或远程主机内的源之间的路径映射。 在大多数情况下,PhpStorm 会检测路径映射和容器设置,并自动填写所有字段。 或者,单击字段旁边的 |
Docker 容器 | 用于从镜像启动容器的 Docker 容器设置。 这些设置可能包括卷配置、暴露的端口、网络等内容。 |
Behat 库
在此区域,指定要使用的 Behat 安装。
Behat 可执行文件路径 | 在此字段中,指定 behat.phar 存档或包含 Behat 可执行文件的文件夹的位置。 Behat 不一定需要安装在当前项目根目录下。 您可以手动输入路径或单击 |
Behat 版本发布 | 单击此链接以导航到 GitHub 上的 Behat 仓库,您可以在其中选择相关版本的 behat.phar 存档。 |
Behat 版本 | 此只读字段显示指定 Behat 安装的版本。 当您单击 刷新 图标 |
测试运行器
在此区域,设置用于启动和执行场景的配置 YML 文件的路径。
默认配置文件 | 选中此复选框以指定 YML 文件的路径,将其用作所有 Behat 运行/调试配置的默认配置文件。 清除复选框以让 Behat 使用项目根文件夹中的 behat.yml 或 behat.yml.dist 配置文件。 如果未找到此类文件,测试执行将失败。 因此,显式指定配置文件可能更可靠。 |
PHPSpec
在此窗格中,配置通过已配置的本地和远程 PHP 解释器可用的 PHPSpec 工具集安装。
PHPSpec 库
在此区域,指定要使用的 PHPSpec 安装。
PHPSpec 可执行文件的路径 | 在此字段中,指定 phpspec 的位置。 PHPSpec 不一定需要安装在当前项目根目录下。 如果未为 本地解释器指定 PHPSpec 的路径,PhpStorm 将无法提供对 PHPSpec 的完整支持,例如,不会显示代码补全建议,也无法解析引用。 |
前缀('spec_prefix') | 此只读字段显示规范的命名空间前缀。 PhpStorm 从 默认配置文件 字段中指定的配置文件中检测 |
测试运行器
在此区域,设置用于启动和执行场景的配置 YML 文件的路径。
默认配置文件 | 选中此复选框以指定 YML 文件的路径,将其用作所有 PHPSpec 运行/调试配置的默认配置文件。 清除复选框以让 PHPSpec 使用项目根文件夹中的 phpspec.yml 或 phpspec.yml.dist 配置文件。 如果未找到此类文件,测试执行将失败。 因此,显式指定配置文件可能更可靠。 |
CLI 解释器 | 用于运行 PHPSpec 的远程 PHP CLI 解释器。 CLI 解释器 字段是只读的。 单击 |
路径映射 | 在本地源与 Vagrant 实例、Docker 容器或远程主机内的源之间的路径映射。 在大多数情况下,PhpStorm 会检测路径映射和容器设置,并自动填写所有字段。 或者,单击字段旁边的 |
Docker 容器 | 用于从镜像启动容器的 Docker 容器设置。 这些设置可能包括卷配置、暴露的端口、网络等内容。 |
PHPSpec 库
在此区域,指定要使用的 PHPSpec 安装。
PHPSpec 可执行文件的路径 | 在此字段中,指定 phpspec 的位置。 PHPSpec 不一定需要安装在当前项目根目录下。 如果未为 本地解释器指定 PHPSpec 的路径,PhpStorm 将无法提供对 PHPSpec 的完整支持,例如,不会显示代码补全建议,也无法解析引用。 |
测试运行器
在此区域,设置用于启动和执行场景的配置 YML 文件的路径。
默认配置文件 | 选中此复选框以指定 YML 文件的路径,将其用作所有 PHPSpec 运行/调试配置的默认配置文件。 清除复选框以让 PHPSpec 使用项目根文件夹中的 phpspec.yml 或 phpspec.yml.dist 配置文件。 如果未找到此类文件,测试执行将失败。 因此,显式指定配置文件可能更可靠。 |
Codeception
在此窗格中,配置通过已配置的本地和远程 PHP 解释器可用的 Codeception 框架安装。
Codeception 库
在此区域,指定要使用的 Codeception 安装。
Codeception 可执行文件路径 | 在此字段中,指定 codeception.phar 存档或包含 Codeception 可执行文件的文件夹的位置。 |
Codeception 版本发布 | 单击此链接以导航到 GitHub 上的 Codeception 仓库,您可以在其中选择相关版本的 codeception.phar 存档。 |
Codeception 版本 | 此只读字段显示指定 Codeception 安装的版本。 当您单击 |
测试运行器
在此区域,设置用于启动和执行场景的配置 YML 文件的路径。
默认配置文件 | 选中此复选框以指定 YML 文件的路径,将其用作所有 Codeception 运行/调试配置的默认配置文件。 清除复选框以让 Codeception 使用项目根文件夹中的 codeception.yml 或 codeception.dist.yml 配置文件。 如果未找到此类文件,测试执行将失败。 因此,显式指定配置文件可能更可靠。 |
CLI 解释器 | 用于运行 Codeception 的远程 PHP CLI 解释器。 CLI 解释器 字段是只读的。 单击 |
路径映射 | 在本地源与 Vagrant 实例、Docker 容器或远程主机内的源之间的路径映射。 在大多数情况下,PhpStorm 会检测路径映射和容器设置,并自动填写所有字段。 或者,单击字段旁边的 |
Docker 容器 | 用于从镜像启动容器的 Docker 容器设置。 这些设置可能包括卷配置、暴露的端口、网络等内容。 |
Codeception 库
在此区域,指定要使用的 Codeception 安装。
Codeception 可执行文件路径 | 在此字段中,指定 codeception.phar 存档或包含 Codeception 可执行文件的文件夹的位置。 |
Codeception 版本发布 | 单击此链接以导航到 GitHub 上的 Codeception 仓库,您可以在其中选择相关版本的 codeception.phar 存档。 |
Codeception 版本 | 此只读字段显示指定 Codeception 安装的版本。 当您单击 |
测试运行器
在此区域,设置用于启动和执行场景的配置 YML 文件的路径。
默认配置文件 | 选中此复选框以指定 YML 文件的路径,将其用作所有 Codeception 运行/调试配置的默认配置文件。 清除复选框以让 Codeception 使用项目根文件夹中的 codeception.yml 或 codeception.dist.yml 配置文件。 如果未找到此类文件,测试执行将失败。 因此,显式指定配置文件可能更可靠。 |
Pest
在此窗格中,配置通过已配置的本地和远程 PHP 解释器可用的 Pest 测试框架安装。
Pest 库
Pest 可执行文件路径 | pest 可执行文件的绝对路径。 单击 如果您使用 Composer 在项目中安装 Pest 依赖项,PhpStorm 会自动检测已安装的 Pest 可执行文件。 |
测试运行器
默认配置文件 | 默认情况下,PhpStorm 会检测并使用项目根文件夹中的 phpunit.xml 或 phpunit.xml.dist 配置文件。 要使用自定义配置文件,请选中复选框并指定要使用的配置文件的位置。 手动输入路径或单击 |
CLI 解释器 | 用于运行 Pest 的远程 PHP CLI 解释器。 CLI 解释器 字段是只读的。 单击 |
路径映射 | 在本地源与 Vagrant 实例、Docker 容器或远程主机内的源之间的路径映射。 在大多数情况下,PhpStorm 会检测路径映射和容器设置,并自动填写所有字段。 或者,单击字段旁边的 |
Docker 容器 | 用于从镜像启动容器的 Docker 容器设置。 这些设置可能包括卷配置、暴露的端口、网络等内容。 |
Pest 库
Pest 可执行文件路径 | pest 可执行文件的绝对路径。 单击 |
测试运行器
默认配置文件 | 默认情况下,PhpStorm 会检测并使用项目根文件夹中的 phpunit.xml 或 phpunit.xml.dist 配置文件。 要使用自定义配置文件,请选中复选框并指定要使用的配置文件的位置。 手动输入路径或单击 |