# 单元测试类
单元测试是一种为你的应用程序中的每个函数编写测试的软件开发方法。如果你还不熟悉这个概念， 你应该先去 Google 一下。
CodeIgniter 的单元测试类非常简单，由一个测试方法和两个显示结果的方法组成。 它没打算成为一个完整的测试套件，只是提供一个简单的机制来测试你的代码是否 生成了正确的数据类型和结果。
* [使用单元测试类库](http://codeigniter.org.cn/user_guide/libraries/unit_testing.html#id2)
* [初始化类](http://codeigniter.org.cn/user_guide/libraries/unit_testing.html#id3)
* [运行测试](http://codeigniter.org.cn/user_guide/libraries/unit_testing.html#id4)
* [生成报告](http://codeigniter.org.cn/user_guide/libraries/unit_testing.html#id5)
* [严格模式](http://codeigniter.org.cn/user_guide/libraries/unit_testing.html#id6)
* [启用/禁用单元测试](http://codeigniter.org.cn/user_guide/libraries/unit_testing.html#id7)
* [单元测试结果显示](http://codeigniter.org.cn/user_guide/libraries/unit_testing.html#id8)
* [自定义显示测试结果](http://codeigniter.org.cn/user_guide/libraries/unit_testing.html#id9)
* [创建模板](http://codeigniter.org.cn/user_guide/libraries/unit_testing.html#id10)
* [类参考](http://codeigniter.org.cn/user_guide/libraries/unit_testing.html#id11)
## [使用单元测试类库](http://codeigniter.org.cn/user_guide/libraries/unit_testing.html#id12)
### [初始化类](http://codeigniter.org.cn/user_guide/libraries/unit_testing.html#id13)
正如 CodeIgniter 中的其他类一样，在你的控制器中使用 $this->load->library() 方法来初始化单元测试类:
~~~
$this->load->library('unit_test');
~~~
初始化之后，单元测试类的对象就可以这样访问:
~~~
$this->unit
~~~
### [运行测试](http://codeigniter.org.cn/user_guide/libraries/unit_testing.html#id14)
要运行一个测试用例，需要提供一个测试和一个期望结果，像下面这样:
~~~
$this->unit->run('test', 'expected result', 'test name', 'notes');
~~~
其中，test 是你希望测试的代码的结果，expected result 是期望返回的结果，test name 是可选的， 你可以为你的测试取一个名字，notes 是可选的，可以填些备注信息。例如:
~~~
$test = 1 + 1;
$expected_result = 2;
$test_name = 'Adds one plus one';
$this->unit->run($test, $expected_result, $test_name);
~~~
期望的结果可以是字面量匹配（a literal match），也可以是数据类型匹配（a data type match）。 下面是字面量匹配的例子:
~~~
$this->unit->run('Foo', 'Foo');
~~~
下面是数据类型匹配的例子:
~~~
$this->unit->run('Foo', 'is_string');
~~~
注意第二个参数 "is_string" ，这让方法测试返回的结果是否是字符串类型。以下是可用的数据类型的列表：
* is_object
* is_string
* is_bool
* is_true
* is_false
* is_int
* is_numeric
* is_float
* is_double
* is_array
* is_null
* is_resource
### [生成报告](http://codeigniter.org.cn/user_guide/libraries/unit_testing.html#id15)
你可以在每个测试之后显示出测试的结果，也可以先运行几个测试，然后在最后生成一份测试结果的报告。 要简单的显示出测试结果，可以直接在 run 方法的前面使用 echo:
~~~
echo $this->unit->run($test, $expected_result);
~~~
要显示一份所有测试的完整报告，使用如下代码:
~~~
echo $this->unit->report();
~~~
这份报告会以 HTML 的表格形式显示出来，如果你喜欢获取原始的数据，可以通过下面的代码得到一个数组:
~~~
echo $this->unit->result();
~~~
### [严格模式](http://codeigniter.org.cn/user_guide/libraries/unit_testing.html#id16)
默认情况下，单元测试类在字面量匹配时是松散的类型匹配。看下面这个例子:
~~~
$this->unit->run(1, TRUE);
~~~
正在测试的结果是一个数字，期望的结果是一个布尔型。但是，由于 PHP 的松散数据类型， 如果使用常规的比较操作符的话，上面的测试结果将会是 TRUE 。
> if (1 == TRUE) echo 'This evaluates as true';
如果愿意的话，你可以将单元测试设置为严格模式，它不仅会比较两个数据的值， 而且还会比较两个数据的数据类型:
~~~
if (1 === TRUE) echo 'This evaluates as FALSE';
~~~
使用如下代码启用严格模式:
~~~
$this->unit->use_strict(TRUE);
~~~
### [启用/禁用单元测试](http://codeigniter.org.cn/user_guide/libraries/unit_testing.html#id17)
如果你希望在你的代码中保留一些测试，只在需要的时候才被执行，可以使用下面的代码禁用单元测试:
~~~
$this->unit->active(FALSE);
~~~
### [单元测试结果显示](http://codeigniter.org.cn/user_guide/libraries/unit_testing.html#id18)
单元测试的结果默认显示如下几项：
* Test Name (test_name)
* Test Datatype (test_datatype)
* Expected Datatype (res_datatype)
* Result (result)
* File Name (file)
* Line Number (line)
* Any notes you entered for the test (notes)
你可以使用 $this->unit->set_test_items() 方法自定义要显示哪些结果，例如， 你只想显示出测试名和测试的结果：
#### [自定义显示测试结果](http://codeigniter.org.cn/user_guide/libraries/unit_testing.html#id19)
~~~
$this->unit->set_test_items(array('test_name', 'result'));
~~~
#### [创建模板](http://codeigniter.org.cn/user_guide/libraries/unit_testing.html#id20)
如果你想让你的测试结果以不同于默认的格式显示出来，你可以设置你自己的模板， 这里是一个简单的模板例子，注意那些必须的伪变量:
~~~
$str = '
<table border="0" cellpadding="4" cellspacing="1">
{rows}
<tr>
<td>{item}</td>
<td>{result}</td>
</tr>
{/rows}
</table>';
$this->unit->set_template($str);
~~~
注解
你的模板必须在运行测试 **之前** 被定义。
## [类参考](http://codeigniter.org.cn/user_guide/libraries/unit_testing.html#id21)
classCI_Unit_test
set_test_items($items)
参数:
* **$items** (array) -- List of visible test items
返回: void
设置要在测试的结果中显示哪些项，有效的选项有：
>
>
> * test_name
> * test_datatype
> * res_datatype
> * result
> * file
> * line
> * notes
>
>
run($test[, $expected = TRUE[, $test_name = 'undefined'[, $notes = '']]])
参数:
* **$test** (mixed) -- Test data
* **$expected** (mixed) -- Expected result
* **$test_name** (string) -- Test name
* **$notes** (string) -- Any notes to be attached to the test
返回: Test report
返回类型: string
运行单元测试。
report([$result = array()])
参数:
* **$result** (array) -- Array containing tests results
返回: Test report
返回类型: string
根据已运行的测试生成一份测试结果的报告。
use_strict([$state = TRUE])
参数:
* **$state** (bool) -- Strict state flag
返回类型: void
在测试中启用或禁用严格比较模式。
active([$state = TRUE])
参数:
* **$state** (bool) -- Whether to enable testing
返回类型: void
启用或禁用单元测试。
result([$results = array()])
参数:
* **$results** (array) -- Tests results list
返回: Array of raw result data
返回类型: array
返回原始的测试结果数据。
set_template($template)
参数:
* **$template** (string) -- Test result template
返回类型: void
设置显示测试结果数据的模板。
- 欢迎使用 CodeIgniter
- 安装说明
- 下载 CodeIgniter
- 安装说明
- 从老版本升级
- 疑难解答
- CodeIgniter 概览
- CodeIgniter 将从这里开始
- CodeIgniter 是什么？
- 支持特性
- 应用程序流程图
- 模型-视图-控制器
- 设计与架构目标
- 教程 - 内容提要
- 加载静态内容
- 读取新闻条目
- 创建新闻条目
- 结束语
- 常规主题
- CodeIgniter URL
- 控制器
- 保留名称
- 视图
- 模型
- 辅助函数
- 使用 CodeIgniter 类库
- 创建类库
- 使用 CodeIgniter 驱动器
- 创建驱动器
- 创建核心系统类
- 创建附属类
- 钩子 - 扩展框架核心
- 自动加载资源
- 公共函数
- 兼容性函数
- URI 路由
- 错误处理
- 网页缓存
- 程序分析
- 以 CLI 方式运行
- 管理你的应用程序
- 处理多环境
- 在视图文件中使用 PHP 替代语法
- 安全
- PHP 开发规范
- 类库参考
- 基准测试类
- 缓存驱动器
- 日历类
- 购物车类
- 配置类
- Email 类
- 加密类
- 加密类（新版）
- 文件上传类
- 表单验证类
- FTP 类
- 图像处理类
- 输入类
- Javascript 类
- 语言类
- 加载器类
- 迁移类
- 输出类
- 分页类
- 模板解析类
- 安全类
- Session 类
- HTML 表格类
- 引用通告类
- 排版类
- 单元测试类
- URI 类
- 用户代理类
- XML-RPC 与 XML-RPC 服务器类
- Zip 编码类
- 数据库参考
- 数据库快速入门: 示例代码
- 数据库配置
- 连接你的数据库
- 查询
- 生成查询结果
- 查询辅助函数
- 查询构造器类
- 事务
- 数据库元数据
- 自定义函数调用
- 数据库缓存类
- 数据库工厂类
- 数据库工具类
- 数据库驱动器参考
- 辅助函数参考
- 数组辅助函数
- 验证码辅助函数
- Cookie 辅助函数
- 日期辅助函数
- 目录辅助函数
- 下载辅助函数
- 邮件辅助函数
- 文件辅助函数
- 表单辅助函数
- HTML 辅助函数
- 语言辅助函数
- Inflector 辅助函数
- 数字辅助函数
- 路径辅助函数
- 安全辅助函数
- 表情辅助函数
- 字符串辅助函数
- 文本辅助函数
- 排版辅助函数
- URL 辅助函数
- XML 辅助函数
- 向 CodeIgniter 贡献你的力量