fangx / testing
Hyperf 数据库测试支持
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.
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); } }