移动 tests 到 thinkphp 目录

tests/README.md

@@ -0,0 +1,163 @@
+###测试目录结构###
+测试文件主要在tests文件下面，主要有以下几个文件夹
+- mock 小核心文件，用于做文件加载，引入框架等操作。
+- framework 真正的测试文件，和项目文件夹机构一致，但是里面都是测试文件
+  - think
+     - application
+     - public
+     - tests
+     - thinkphp
+     - 其他文件
+
+###准备工作###
+1. 判断渲染，若果是测试环境则不执行渲染，主要在library/think/app.php文件中，修改其中的第116行：
+
+  ```php
+  if (defined('IN_UNIT_TEST')) {
+      return $data;
+  } else {
+      Response::returnData($data, Config::get('default_return_type'), Config::get('response_exit'));
+  }
+  ```
+  和129行
+
+  ```php
+  if (defined('IN_UNIT_TEST')) {
+      return $data;
+  } else {
+      Response::returnData($data, Config::get('default_return_type'), Config::get('response_exit'));
+  }
+  ```
+
+2. 修改config.php，添加重置配置函数：
+
+  ```php
+  // 重置配置参数
+  public static function reset($name, $value = null, $range = ''){
+     self::$config = [];
+  }
+  ```
+
+3. 添加mock文件，在文件中添加单元测试定义，以及请求定义，否则报错。
+
+  ```php
+  <?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
+  <?php
+  namespace think\cache\driver;
+
+  class apcTest extends \PHPUnit_Framework_TestCase
+  {
+      //设定基境
+      public function setUp()
+      {
+      }
+  }
+  ```
+
+2. 编写测试文件
+   - 引用app、config和cache
+
+  ```php
+  use think\app;
+  use think\cache;
+  use think\config;
+  ```
+   - 在setUp函数中设定require条件
+
+  ```php
+  if(!extension_loaded('apc')){
+     $this->markTestSkipped('apc扩展不可用！');
+  };
+  ```
+
+   - 编写测试用例
+
+   	*具体写法参照 [PHPUnit 官方文档](https://phpunit.de/manual/4.8/zh_cn/index.html)*
+
+  ```php
+  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. 回到根目录执行单元测试命令：
+    ```bash
+    $ phpunit
+    ```
+    若想看到所有结果，请添加-v参数
+    ```bash
+    $ 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|||