framework/tests/README.md

###测试目录结构### 测试文件主要在tests文件下面，主要有以下几个文件夹

• mock 小核心文件，用于做文件加载，引入框架等操作。
• framework 真正的测试文件，和项目文件夹机构一致，但是里面都是测试文件
  • think
    • application
    • public
    • tests
    • thinkphp
    • 其他文件

###准备工作###

1. 判断渲染，若果是测试环境则不执行渲染，主要在library/think/app.php文件中，修改其中的第116行：

if (defined('IN_UNIT_TEST')) {
    return $data;
} else {
    Response::returnData($data, Config::get('default_return_type'), Config::get('response_exit'));
}

和129行

if (defined('IN_UNIT_TEST')) {
    return $data;
} else {
    Response::returnData($data, Config::get('default_return_type'), Config::get('response_exit'));
}

2. 修改config.php，添加重置配置函数：

// 重置配置参数
public static function reset($name, $value = null, $range = ''){
   self::$config = [];
}

3. 添加mock文件，在文件中添加单元测试定义，以及请求定义，否则报错。

<?php
// 测试入口文件
define('IN_UNIT_TEST', true);
$_SERVER['REQUEST_METHOD'] = 'GET';
// 定义项目路径
define('APP_PATH', __DIR__ . '/../application/');
// 开启调试模式
define('APP_DEBUG', true);
// 加载框架引导文件
require __DIR__ . '/../thinkphp/start.php';

###主要测试流程### thinkphp5的测试的主要流程是跟think的系统流程是相似的，大体的流程为：

1. 引用bootstrap文件加载mock里的小框架文件，加载所需文件

2. 根据文件目录，添加测试文件

3. 执行单元测试，输出结果

###测试举例### 例如测试thinkphp里的apc缓存，将分为以下几个过程：

1. 在tests/framework文件夹下创建apcTest.php文件，该文件应与apc.php目录路径(thinkphp/library/think/cache/driver)一致，并引用 PHPUnit_Framework_TestCase。

<?php
namespace think\cache\driver;

class apcTest extends \PHPUnit_Framework_TestCase
{
    //设定基境
    public function setUp()
    {
    }
}

2. 编写测试文件
   • 引用app、config和cache

use think\app;
use think\cache;
use think\config;

• 在setUp函数中设定require条件

if(!extension_loaded('apc')){
   $this->markTestSkipped('apc扩展不可用！');
};

• 编写测试用例

*具体写法参照 [PHPUnit 官方文档](https://phpunit.de/manual/4.8/zh_cn/index.html)*

public function testGet()
{
    App::run();
    $this->assertInstanceOf(
        '\think\cache\driver\Apc',
        Cache::connect(['type' => 'apc', 'expire' => 1])
    );
    $this->assertTrue(Cache::set('key', 'value'));
    $this->assertEquals('value', Cache::get('key'));
    $this->assertTrue(Cache::rm('key'));
    $this->assertFalse(Cache::get('key'));
    $this->assertTrue(Cache::clear('key'));
    Config::reset();
}

3. 回到根目录执行单元测试命令：

   $ phpunit
   

   若想看到所有结果，请添加-v参数

   $ phpunit -v
   

4. 输出结果

###相关文档###
[各个部分单元测试说明](http://www.kancloud.cn/brother_simon/tp5_test/96971 "各部分单元测试说明")

###大家一起来###
单元测试的内容会跟框架同步，测试内容方方面面，是一个相对复杂的模块，同时也是一个值得重视的部分。希望大家能够多多提出意见，多多参与。如果你有任何问题或想法，可以随时提issue，我们期待着收到听大家的质疑和讨论。

## 任务进度
单元测试任务进度，请大家认领模块

|模块|认领人|进度|
|---|---|---|
|Base|||
|App|||
|Build|||
|Config|||
|Cache|||
|Controller|||
|Cookie|||
|Db|||
|Debug|大漠||
|Error|大漠||
|Hook|||
|Input|||
|Lang|||
|Loader|||
|Log|||
|Model|||
|Response|大漠|√|
|Route|||
|Session|大漠|√|
|Template|||
|Url|||
|View|||