fangx/testing

Hyperf 数据库测试支持

v3.2.0 2021-07-19 06:40 UTC

README

Hyperf 中单元测试增强扩展包

  • 支持数据库测试。
  • 支持直接对 Http Response 进行断言。
  • 支持事件断言,而不是直接执行事件。
  • 支持队列断言,而不是直接执行队列。
  • 支持伪造 Http 响应,而不需要真正向第三方发送请求。
  • 支持 Blade 视图渲染测试。

在 Hyperf 中使用数据库进行单元测试。

推荐使用 fangx/sqlite-driver 作为数据库驱动进行测试。

为了保证测试独立,每个测试完成后都会重新刷新容器。这种情况下会导致在使用异步协程时,每次通过 ApplicationContext::getContainer() 获取到的容器可能不同。在异步中应避免直接使用 ApplicationContext::getContainer() 获取容器内容。Hyperf 官方推荐的做法是通过构造函数直接注入 Container,而不是每次使用容器都通过 ApplicationContext::getContainer() 获取。

安装

composer require fangx/testing --dev

使用

Hyperf 2.0 使用 2.1 版本,Hyperf 2.1 使用 3.* 版本

  • Fangx\Testing\Concerns\CommandCaller: 提供 command() 方法,在程序中执行命令。
  • Fangx\Testing\Concerns\DatabaseMigrations: 参考 Laravel。需要依赖 CommandCaller 执行迁移命令。
  • Fangx\Testing\Concerns\RefreshDatabase: 参考 Laravel。
  • Fangx\Testing\Concerns\DatabaseTransactions: 参考 Laravel。

运行迁移时,默认执行的是 migrations/testing 目录下的迁移文件。可以通过设置 getMigrationsPath 方法来自定义迁移文件的目录。

使用命令创建

php bin/hyperf.php fx:test UserTest
php bin/hyperf.php fx:test UserTest --unit

直接创建

在项目中的测试目录下创建 Units/UserTest.php 填入以下内容。

<?php
namespace HyperfTest\Cases;

class UserTest extends \Fangx\Testing\TestCase
{
    use \Fangx\Testing\Concerns\CommandCaller;
    use \Fangx\Testing\Concerns\RefreshDatabase;

    public function testExample()
    {
        $this->assertTrue(true);
    }
}