PhpStorm 2025.2 Help

测试框架

使用此页面将 PHP 测试框架与当前项目中的 PhpStorm 集成。 使用 PhpStorm,您可以运行和调试 PHPUnitBehatPHPSpecCodeceptionPest 测试。

在项目中配置测试框架

  1. 单击 添加图标 并选择测试框架和 PHP 解释器以运行它:

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

    ps_settings_php_test_frameworks_choose_php_interpreter.png
  3. 在右侧窗格中,选择测试框架的来源。

    • 对于 Behat、PHPSpec 和 Codeception,请输入框架可执行文件的路径。

    • 对于 PHPUnit,请指定您使用的框架安装类型,可用选项为 composer 自动加载器 autoload.php phpunit.phar 存档。

  4. 检查所选的远程 PHP 解释器和路径映射。

  5. 可选地,指定配置文件。 对于 PHPUnit,您还可以指定要使用的引导文件。

PHPUnit

在此窗格中,配置要与 PHP 解释器一起使用的 PHPUnit 安装。

PHPUnit 库

在此区域,指定 PHPUnit 安装的类型。 可用选项如下:

使用Composer 自动加载器

选择此选项以运行由 Composer 依赖管理器 安装的 PHPUnit。 该包由 autoload.php 文件从 vendor 文件夹中检索并加载。 在 脚本路径 字段中指定 autoload.php 的位置。

phpunit.phar 路径

选择此选项以从 phar 存档运行 PHPUnit。

  • 如果您的项目中已有 phpunit.phar 存档,请在 phpunit.phar 路径 字段中指定其位置。 手动输入路径或单击 “浏览”按钮 并在打开的对话框中选择文件。

  • 如果您的计算机上尚无 phar 存档,请单击 下载 phpunit.phar... 链接以让 PhpStorm 自动下载。

    无论哪种情况,PhpStorm 都会在测试执行前加载存档。

测试运行器

在此区域,指定用于从 PhpStorm 启动 PHPUnit 测试的 XML 配置文件 的路径。

您还可以指定引导文件的路径,以便在启动测试前始终执行 PHP 脚本。

默认配置文件

选中此复选框以指定 phpunit.xml phpunit.xml.dist 文件的路径,将其用作所有 PHPUnit 运行/调试配置中的默认配置文件。

请注意,您还可以在编辑特定 PHPUnit 运行/调试配置时提供备用配置文件。

如果未指定 XML 配置文件,PhpStorm 默认使用 ‑‑no‑configuration 选项运行 PHPUnit 测试。

默认引导文件

选中此复选框以便在启动测试前始终执行 PHP 脚本。 在字段中指定脚本的位置。 手动输入路径或单击 “浏览”按钮 并在 打开的对话框 中选择所需的文件夹。 请注意,您还可以在编辑特定 PHPUnit 运行/调试配置时提供备用引导文件。

CLI 解释器

用于运行 PHPUnit 的远程 PHP CLI 解释器。 CLI 解释器 字段是只读的。 单击 “浏览”按钮 以在 解释器对话框 中更新所选的解释器。

路径映射

在本地源与 Vagrant 实例、Docker 容器或远程主机内的源之间的路径映射。

在大多数情况下,PhpStorm 会检测路径映射和容器设置,并自动填写所有字段。 或者,单击字段旁边的 “浏览”按钮 并手动指定设置。 更多信息请参阅 配置远程 PHP 解释器

Docker 容器

用于从镜像启动容器的 Docker 容器设置。 这些设置可能包括卷配置、暴露的端口、网络等内容。

PHPUnit 库

在此区域,指定 PHPUnit 安装的类型。 可用选项如下:

使用Composer 自动加载器

选择此选项以运行由 Composer 依赖管理器 安装的 PHPUnit。 该包由 autoload.php 文件从 vendor 文件夹中检索并加载。 在 脚本路径 字段中指定 autoload.php 的位置。

phpunit.phar 路径

选择此选项以从 phar 存档运行 PHPUnit。

  • 如果您的项目中已有 phpunit.phar 存档,请在 phpunit.phar 路径 字段中指定其位置。 手动输入路径或单击 “浏览”按钮 并在打开的对话框中选择文件。

  • 如果您的计算机上尚无 phar 存档,请单击 下载 phpunit.phar... 链接以让 PhpStorm 自动下载。

    无论哪种情况,PhpStorm 都会在测试执行前加载存档。

测试运行器

在此区域,设置用于启动和执行场景的配置 XML 文件的路径。

您还可以输入引导文件的路径,以便在启动测试之前始终执行一个 PHP 脚本。 在字段中指定脚本的位置。 手动输入路径或单击 “浏览”按钮 并在 打开的对话框 中选择所需的文件夹。

默认配置文件

选中此复选框以指定 phpunit.xml phpunit.xml.dist 文件的路径,将其用作所有 PHPUnit 运行/调试配置中的默认配置文件。

请注意,您还可以在编辑特定 PHPUnit 运行/调试配置时提供备用配置文件。

如果未指定 XML 配置文件,PhpStorm 默认使用 ‑‑no‑configuration 选项运行 PHPUnit 测试。

清除复选框以让 PHPUnit 使用项目根文件夹中的 phpunit.xml phpunit.xml.dist 配置文件。 如果未找到此类文件,测试执行将失败。 因此,显式指定配置文件可能更可靠。

默认引导文件

选中此复选框以便在启动测试前始终执行 PHP 脚本。 在字段中指定脚本的位置。 手动输入路径或单击 “浏览”按钮 并在 打开的对话框 中选择所需的文件夹。 请注意,您还可以在编辑特定 PHPUnit 运行/调试配置时提供备用引导文件。

Behat

在此窗格中,配置通过已配置的本地和远程 PHP 解释器可用的 Behat 框架安装。

Behat 库

在此区域,指定要使用的 Behat 安装。

Behat 可执行文件路径

在此字段中,指定 behat.phar 存档或包含 Behat 可执行文件的文件夹的位置。 Behat 不一定需要安装在当前项目根目录下。 您可以手动输入路径或单击 “浏览”按钮 并在打开的对话框中选择相关位置。

Behat 版本发布

单击此链接以导航到 GitHub 上的 Behat 仓库,您可以在其中选择相关版本的 behat.phar 存档。

Behat 版本

此只读字段显示指定 Behat 安装的版本。 当您单击 刷新 图标 刷新按钮 时,PhpStorm 会检测版本。 默认值为 未安装

测试运行器

在此区域,设置用于启动和执行场景的配置 YML 文件的路径。

默认配置文件

选中此复选框以指定 YML 文件的路径,将其用作所有 Behat 运行/调试配置的默认配置文件。

清除复选框以让 Behat 使用项目根文件夹中的 behat.yml behat.yml.dist 配置文件。 如果未找到此类文件,测试执行将失败。 因此,显式指定配置文件可能更可靠。

CLI 解释器

用于运行 Behat 的远程 PHP CLI 解释器。 CLI 解释器 字段是只读的。 单击 “浏览”按钮 以在 解释器对话框 中更新所选的解释器。

路径映射

在本地源与 Vagrant 实例、Docker 容器或远程主机内的源之间的路径映射。

在大多数情况下,PhpStorm 会检测路径映射和容器设置,并自动填写所有字段。 或者,单击字段旁边的 “浏览”按钮 并手动指定设置。 更多信息请参阅 配置远程 PHP 解释器

Docker 容器

用于从镜像启动容器的 Docker 容器设置。 这些设置可能包括卷配置、暴露的端口、网络等内容。

Behat 库

在此区域,指定要使用的 Behat 安装。

Behat 可执行文件路径

在此字段中,指定 behat.phar 存档或包含 Behat 可执行文件的文件夹的位置。 Behat 不一定需要安装在当前项目根目录下。 您可以手动输入路径或单击 “浏览”按钮 并在打开的对话框中选择相关位置。

Behat 版本发布

单击此链接以导航到 GitHub 上的 Behat 仓库,您可以在其中选择相关版本的 behat.phar 存档。

Behat 版本

此只读字段显示指定 Behat 安装的版本。 当您单击 刷新 图标 刷新按钮 时,PhpStorm 会检测版本。 默认值为 未安装

测试运行器

在此区域,设置用于启动和执行场景的配置 YML 文件的路径。

默认配置文件

选中此复选框以指定 YML 文件的路径,将其用作所有 Behat 运行/调试配置的默认配置文件。

清除复选框以让 Behat 使用项目根文件夹中的 behat.yml behat.yml.dist 配置文件。 如果未找到此类文件,测试执行将失败。 因此,显式指定配置文件可能更可靠。

PHPSpec

在此窗格中,配置通过已配置的本地和远程 PHP 解释器可用的 PHPSpec 工具集安装。

PHPSpec 库

在此区域,指定要使用的 PHPSpec 安装。

PHPSpec 可执行文件的路径

在此字段中,指定 phpspec 的位置。 PHPSpec 不一定需要安装在当前项目根目录下。

如果未为 本地解释器指定 PHPSpec 的路径,PhpStorm 将无法提供对 PHPSpec 的完整支持,例如,不会显示代码补全建议,也无法解析引用。

前缀('spec_prefix')

此只读字段显示规范的命名空间前缀。 PhpStorm 从 默认配置文件 字段中指定的配置文件中检测 spec_prefix。 默认值为 spec。 有关更多信息,请参阅 PHPSpec 配置:PSR-4PHPSpec 配置:Spec 和 Source Location

测试运行器

在此区域,设置用于启动和执行场景的配置 YML 文件的路径。

默认配置文件

选中此复选框以指定 YML 文件的路径,将其用作所有 PHPSpec 运行/调试配置的默认配置文件。

清除复选框以让 PHPSpec 使用项目根文件夹中的 phpspec.yml phpspec.yml.dist 配置文件。 如果未找到此类文件,测试执行将失败。 因此,显式指定配置文件可能更可靠。

CLI 解释器

用于运行 PHPSpec 的远程 PHP CLI 解释器。 CLI 解释器 字段是只读的。 单击 “浏览”按钮 以在 解释器对话框 中更新所选的解释器。

路径映射

在本地源与 Vagrant 实例、Docker 容器或远程主机内的源之间的路径映射。

在大多数情况下,PhpStorm 会检测路径映射和容器设置,并自动填写所有字段。 或者,单击字段旁边的 “浏览”按钮 并手动指定设置。 更多信息请参阅 配置远程 PHP 解释器

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 安装的版本。 当您单击 刷新按钮 时,PhpStorm 会检测版本。 默认值为 未安装

测试运行器

在此区域,设置用于启动和执行场景的配置 YML 文件的路径。

默认配置文件

选中此复选框以指定 YML 文件的路径,将其用作所有 Codeception 运行/调试配置的默认配置文件。

清除复选框以让 Codeception 使用项目根文件夹中的 codeception.yml codeception.dist.yml 配置文件。 如果未找到此类文件,测试执行将失败。 因此,显式指定配置文件可能更可靠。

CLI 解释器

用于运行 Codeception 的远程 PHP CLI 解释器。 CLI 解释器 字段是只读的。 单击 “浏览”按钮 以在 解释器对话框 中更新所选的解释器。

路径映射

在本地源与 Vagrant 实例、Docker 容器或远程主机内的源之间的路径映射。

在大多数情况下,PhpStorm 会检测路径映射和容器设置,并自动填写所有字段。 或者,单击字段旁边的 “浏览”按钮 并手动指定设置。 更多信息请参阅 配置远程 PHP 解释器

Docker 容器

用于从镜像启动容器的 Docker 容器设置。 这些设置可能包括卷配置、暴露的端口、网络等内容。

Codeception 库

在此区域,指定要使用的 Codeception 安装。

Codeception 可执行文件路径

在此字段中,指定 codeception.phar 存档或包含 Codeception 可执行文件的文件夹的位置。

Codeception 版本发布

单击此链接以导航到 GitHub 上的 Codeception 仓库,您可以在其中选择相关版本的 codeception.phar 存档。

Codeception 版本

此只读字段显示指定 Codeception 安装的版本。 当您单击 刷新按钮 时,PhpStorm 会检测版本。 默认值为 未安装

测试运行器

在此区域,设置用于启动和执行场景的配置 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 会检测路径映射和容器设置,并自动填写所有字段。 或者,单击字段旁边的 “浏览”按钮 并手动指定设置。 更多信息请参阅 配置远程 PHP 解释器

Docker 容器

用于从镜像启动容器的 Docker 容器设置。 这些设置可能包括卷配置、暴露的端口、网络等内容。

Pest 库

Pest 可执行文件路径

pest 可执行文件的绝对路径。 单击 “浏览”按钮 并在打开的对话框中选择相关位置。

测试运行器

默认配置文件

默认情况下,PhpStorm 会检测并使用项目根文件夹中的 phpunit.xml phpunit.xml.dist 配置文件。

要使用自定义配置文件,请选中复选框并指定要使用的配置文件的位置。 手动输入路径或单击 “浏览”按钮 并在打开的对话框中选择相关位置。

最后修改日期: 2025年 9月 26日