一、总览

 什么是simpletest?

Simpletest的核心是一套建立在测试用例类上的测试框架。这些测试用例类都是继承自测试用例基类，每个测试用例实际上是测试代码。顶层的测试脚本调用run方法按照顺序执行所有用例类。每个测试方法都调用assert的变种函数来判断测试的结果。

下面是一个测试用例的例子：

<?php

class MyTestCase extends UnitTestCase {

    function testLogWroteMessage() {

        $log = &new Log('my.log');

        $log->message('Hello');

        $this->assertTrue(file_exists('my.log'));

    }

}

?>

这些工具是为开发者而写的。测试用php语言写成。用php语言的优势是不用学习新的语言，测试可以马上开始，开发者可以测试任何部分代码。一般所有能被应用程序访问的代码，也能被测试代码访问，如果他们是同一种语言的话。

测试用例最简单的类型是UnitTestCase，这个类包含了所有用于质量、引用、模式匹配的标准测试。这些是绝大多数日常开发的测试所需要的。

Web应用程序的顶级任务不是产生正确的输出，而是生成页面。WebTestCase类用于测试web页面。他仿真了web浏览器对页面的请求，包括cookie、代理、安全连接、验证、表单、frame以及大多数导航元素。有了这个类，开发者能判断页面的信息正确与否。

一个web测试用例的例子：

<?php

class MySiteTest extends WebTestCase {

    function testHomePage() { 

        $this->get('http://www.my-site.com/index.php'); 

        $this->assertTitle('My Home Page'); 

        $this->clickLink('Contact'); 

        $this->assertTitle('Contact me'); 

        $this->assertPattern('/Email me at/'); 

    } 

}

?>

二、单元测试

单元测试用例

下面是一个测试用例的样例：

class FileTestCase extends UnitTestCase { 

} 

一般的，测试用例中总是有一些方法，这些方法的名称以”test”开头，这些方法会在run中被自动调用，应该根据实际需要尽可能多的增加测试方法。

例如：

require_once('../classes/writer.php');

class FileTestCase extends UnitTestCase {

    function FileTestCase() {

        $this->UnitTestCase('File test');

    }

    function setUp() { 

        @unlink('../temp/test.txt'); 

    } 

    function tearDown() { 

        @unlink('../temp/test.txt'); 

    } 

    function testCreation() { 

        $writer = &new FileWriter('../temp/test.txt'); 

        $writer->write('Hello'); 

        $this->assertTrue(file_exists('../temp/test.txt'), 'File created'); 

    } 

}

构造函数是可选的，通常被省略。

在上面的例子中，我们唯一的方法是testCreation函数，用于测试文件是否被Writer对象创建。我们也能在这个方法中放上unlink函数，但是我们将清理临时文件的任务交给了setUp和tearDown。

setUp运行于每个测试方法运行之前，tearDown运行于每个测试方法运行之后。

我们用assert系列函数来判断运行结果。下面是UnitTestCase类的全部assert函数列表：

所有的assert函数能加一个可选的描述作为最后一个参数。这能标识结果。如果省略此函数，将显示默认提示。默认提示字符串也能在自定义字符串中用”%s”来引用，所有判断返回true表示通过，返回false表示失败！

下面是一些例子：

$variable = null;

$this->assertNull($variable, 'Should be cleared'); 

…将通过，并且不显示信息。如果你设置了通过的也要显示的设置器，消息将被显示。

$this->assertIdentical(0, false, 'Zero is not false [%s]'); 

这个函数将失败，当他执行类型检查时，”%s”将被默认的错误消息替换。

$a = 1;

$b = $a;

$this->assertReference($a, $b); 

将失败，因为a是b的副本。

$this->assertPattern('/hello/i', 'Hello world'); 

将通过，因为用大小写不敏感匹配，hello包含在Hello world中。

单元测试用例也有一些方便的方法用于调试和扩展用例：

继承测试用例

当然附加的测试方法能被加到创建特殊的测试用例，看下例：

require_once('simpletest/unit_tester.php');

class FileTester extends UnitTestCase { 

    function FileTester($name = false) { 

        $this->UnitTestCase($name); 

    } 

    function assertFileExists($filename, $message = '%s') { 

        $this->assertTrue( 

                file_exists($filename), 

                sprintf($message, 'File [$filename] existence check')); 

    } 

}

这儿，SimpleTest库放在本地目录simpletest中，用你的服务器路径代替它。

为了防止这个用例运行，应该明智的将它标记为abstract。

新的用例现在能将它作为单元测试用例基类，继承于它，看下例：

class FileTestCase extends FileTester {

    function setUp() {

        @unlink('../temp/test.txt');

    }

    function tearDown() {

        @unlink('../temp/test.txt');

    }

    function testCreation() {

        $writer = &new FileWriter('../temp/test.txt');

        $writer->write('Hello');

        $this->assertFileExists('../temp/test.txt'); 

    }

}

如果你想要的测试用例不需要UnitTestCase的一些assert函数，只有你自己的一些基础函数，那么你需要继承于SimpleTestCase，他在simple_test.php中。

 运行单个测试用例

一般你很少运行单个测试用例，除非你遇到了一个非常困难的模块。下面是一个运行单个测试用例的例子：

<?php

    require_once('simpletest/unit_tester.php');

    require_once('simpletest/reporter.php'); 

    require_once('../classes/writer.php');

    class FileTestCase extends UnitTestCase {

        function FileTestCase() {

            $this->UnitTestCase('File test');

        }

    }     

    $test = &new FileTestCase(); 

    $test->run(new HtmlReporter()); 

?>

这个用例将运行，运行结果是0个通过，0个失败，除非你加了测试方法。