单元测试类 | Unit Testing Class

Unit Testing Class

单元测试是软件开发的一种方法，其中为应用程序中的每个功能编写测试。如果你对这个概念不熟悉，你可以在这个主题上进行一些搜索。

CodeIgniter的单元测试类非常简单，包含一个评估函数和两个结果函数。它不是一个完整的测试套件，而是一个简单的机制来评估你的代码，以确定它是否产生正确的数据类型和结果。

• 使用单元测试库

使用单元测试库

初始化类

像CodeIgniter中的大多数其他类一样，Unit Test类在您的控制器中使用$ this-> load-> library函数进行初始化：

$this->load->library('unit_test'

加载后，单元测试对象将可用 $this->unit

运行测试

运行测试包括以下列方式提供测试和预期结果：

$this->unit->run(‘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

您提供的预期结果可以是文字匹配，也可以是数据类型匹配。这是一个文字的例子：

$this->unit->run('Foo', 'Foo'

这是一个数据类型匹配的例子：

$this->unit->run('Foo', 'is_string'

注意在第二个参数中使用“is_string”？这告诉函数来评估你的测试是否产生一个字符串作为结果。以下是允许的比较类型列表：

• is_object

生成报告

您可以在每次测试后显示结果，也可以运行多个测试并在最后生成报告。要直接显示报告，只需回显或返回运行功能：

echo $this->unit->run($test, $expected_result

要运行所有测试的完整报告，请使用以下命令：

echo $this->unit->report(

该报告将被格式化为HTML表格供查看。如果您更喜欢原始数据，则可以使用以下方法检索数组：

echo $this->unit->result(

严格模式

默认情况下，单元测试类会松散地评估文字匹配。考虑这个例子：

$this->unit->run(1, TRUE

测试正在评估一个整数，但预期的结果是一个布尔值。但是，由于PHP数据松散，PHP会使用普通的相等性测试将上述代码评估为TRUE：

if (1 == TRUE) echo 'This evaluates as true';

如果你愿意，你可以把单元测试类放在严格模式下，它将比较数据类型和值：

if (1 === TRUE) echo 'This evaluates as FALSE';

要启用严格模式，请使用以

$this->unit->use_strict(TRUE

启用/禁用单元测试

如果您想在脚本中保留一些测试，但是除非您需要，否则不会运行测试，您可以使用以下命令禁用单元测试：

$this->unit->active(FALSE

单元测试显示

当您的单元测试结果显示时，下列项目默认显示：

• 测试名称（test_name）

您可以使用$ this-> unit-> set_test_items（）来自定义其中哪些项目显示。例如，如果您只想显示测试名称和结果：

定制显示的测试

$this->unit->set_test_items(array('test_name', 'result')

创建一个模板

如果你希望你的测试结果格式不同，那么你可以设置你自己的模板。这是一个简单模板的例子。请注意所需的伪变量：

$str = '
<table border="0" cellpadding="4" cellspacing="1">
{rows}
        <tr>
                <td>{item}</td>
                <td>{result}</td>
        </tr>
{/rows}
</table>';

$this->unit->set_template($str

注意

在运行单元测试过程之前，必须声明您的模板。

类参考

class CI_Unit_testset_test_items($items)

• $ items（array） - 可见测试项目列表

Returns:  void

设置应在测试中可见的项目列表。有效的选项是：

• test_name

run($test[, $expected = TRUE[, $test_name = 'undefined'[, $notes = '']]])

• $ test（混合） - 测试数据

Returns:  Test report

Return type:  string

Runs unit tests.

report([$result = array()])

• $ result（array） - 包含测试结果的数组

Returns:  Test report

Return type:  string

生成关于已完成测试的报告。

use_strict([$state = TRUE])

• $ state（bool） - 严格状态标志

Return type:  void

Enables/disables strict type comparison in tests.

active([$state = TRUE])

• $ state（bool） - 是否启用测试

Return type:  void

启用/禁用单元测试。

result([$results = array()])

• $ results（array） - 测试结果列表

返回：原始结果数据的数组

Return type:  array

返回原始测试结果数据。

set_template($template)

• $ template（string） - 测试结果模板

Return type:  void

设置用于显示测试结果的模板。