Phpunit 组件

EasySwoole/Phpunit 是对 Phpunit 的协程定制化封装，主要为解决自动协程化入口的问题。并屏蔽了 Swoole ExitException。

组件要求

php: >= 7.3
ext-swoole: ^4.4.0
phpunit/phpunit: ^9.3

安装方法

composer require easyswoole/phpunit

仓库地址

easy-swoole/phpunit

基本使用

./vendor/bin/co-phpunit tests

或者使用以下方式：

php easyswoole.php phpunit tests

默认采用协程容器去执行测试用例，使用非协程采用以下方式：

php easyswoole.php phpunit --no-coroutine

注：tests 为要的测试目录，用于放需要进行单元测试的文件。

预处理

easyswoole/phpunit 支持在项目目录下定义一个 phpunit.php，用户可以在该文件中，进行统一的测试前预处理，其他测试与 phpunit 一致。

如何进行单元测试

这里以 ORM 组件为测试演示：

连接注册

请在 EasySwoole 全局的 initialize 事件中注册。

<?php

namespace EasySwoole\EasySwoole;

use EasySwoole\EasySwoole\AbstractInterface\Event;
use EasySwoole\EasySwoole\Swoole\EventRegister;
use EasySwoole\ORM\Db\Connection;
use EasySwoole\ORM\DbManager;

class EasySwooleEvent implements Event
{
    public static function initialize()
    {
        date_default_timezone_set('Asia/Shanghai');

        $config = new \EasySwoole\ORM\Db\Config(Config::getInstance()->getConf("MYSQL"));
        DbManager::getInstance()->addConnection(new Connection($config));
    }

    public static function mainServerCreate(EventRegister $register)
    {

    }
}

预处理

请在 EasySwoole 项目根目录下创建 phpunit.php 文件。

<?php

use EasySwoole\EasySwoole\Core;

require_once __DIR__ . '/vendor/autoload.php';

Core::getInstance()->initialize();

注：在 3.4.x 之前版本，initialize 事件调用为：EasySwoole\EasySwoole\Core::getInstance()->initialize()->globalInitialize();。

编写测试用例

新建 tests\DbTest.php，编辑内容如下：

<?php

namespace Tests;
use EasySwoole\Mysqli\QueryBuilder;
use PHPUnit\Framework\TestCase;
use EasySwoole\ORM\DbManager;

class DbTest extends TestCase
{
    function testCon()
    {
        $builder = new QueryBuilder();
        $builder->raw('select version()');
        $ret = DbManager::getInstance()->query($builder,true)->getResult();
        $this->assertArrayHasKey('version()',$ret[0]);
    }
}

注：请注册 composer.json 下 Tests 命名空间与 tests 目录的映射关系。

映射关系大致如下所示：

{
    "require": {
        "easyswoole/easyswoole": "3.4.4",
        "easyswoole/phpunit": "^1.0",
        "easyswoole/orm": "^1.4"
    },
    "autoload": {
        "psr-4": {
            "App\\": "App/",
            "Tests\\": "tests/"
        }
    }
}

然后执行 composer dumpautoload。

执行