fangx/testing

hyperf database testing support

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

Requires

• php: >=7.2
• ext-swoole: >=4.5
• hyperf/contract: 2.*
• hyperf/db-connection: 2.*
• hyperf/devtool: 2.*
• hyperf/di: 2.*
• hyperf/utils: 2.*
• phpunit/phpunit: ^9.0
• psr/container: ^1.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^2.9
• malukenho/docheader: ^0.1.6
• mockery/mockery: ^1.0
• swoole/ide-helper: ^4.5

Suggests

• fangx/sqlite-driver: Required to use sqlite driver for database.

MIT

• nfangxu

• php
• testing
• sqlite
• hyperf

README

Hyperf 中单元测试增强扩展包

• 支持数据库测试.
• 支持 Http Response 直接进行断言.
• 支持 Event 断言, 而不是直接执行 Event.
• 支持 Queue 断言, 而不是直接执行 Queue.
• 支持 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. 需要依赖 CommandCaller 执行迁移命令.
• 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);
    }
}