Yii框架官方指南系列增补版40——测试：功能测试（Functional Testing ）

在阅读本章节之前, 强烈推荐你先阅读Selenium文档和 PHPUnit文档. 下面我们简要概述在Yii框架中编写功能测试的基本原则:

• 和单元测试一样, 功能测试以继承子自CWebTestCase的XyzTest类的形式编写, 其中 Xyz 代表被测试的类. 由于 PHPUnit_Extensions_SeleniumTestCase 是 CWebTestCase的祖先类, 我们我们可以从这个类中继承所有方法.

• 功能测试类以XyzTest.php的形式保存在PHP文件中.方便起见, 功能测试文件通常保存在 protected/tests/functional文件夹下.

• 测试类主要包含一系列命名为testAbc的测试方法, 其中 Abc 通常是要测试的特性的名字，例如, 想要测试用户登录功能, 我们可能会有一个命名为 testLogin的测试方法.

• 测试方法包含一系列的用于测试 Selenium RC和web应用之间进行交互的命令语句. 它还包含用于确认我们所期望的web应用回复的断言语句.

在描述如何写一个功能测试之前, 我们先看看通过yiic webapp命令自动生成的 WebTestCase.php 文件。这个文件定义了作为所有功能测试类的基类 WebTestCase:

define('TEST_BASE_URL','http://localhost/yii/demos/blog/index-test.php/');

class WebTestCase extends CWebTestCase
{
    /**
     * Sets up before each test method runs.
     * This mainly sets the base URL for the test application.
     */
    protected function setUp()
    {
        parent::setUp();
        $this->setBrowserUrl(TEST_BASE_URL);
    }

    ......
}

WebTestCase主要设置了测试页面的根 URL，后面在测试方法中我们可以使用相对URLs来指定要测试的页面。

我们还要注意，在测试根 URL中, 使用了 index-test.php 作为入口脚本而不是 index.php. 两者之间的唯一不同就是前者使用test.php作为应用配置文件，而后者使用的是 main.php.

现在我们开始讲述测试在blog演示中如何测试显示一篇文章这一功能特性. 首先编写如写的测试类, 注意测试类继承自我们上面所述的基类 WebTestCase:

class PostTest extends WebTestCase
{
    public $fixtures=array(
        'posts'=>'Post',
    );

    public function testShow()
    {
        $this->open('post/1');
        // verify the sample post title exists
        $this->assertTextPresent($this->posts['sample1']['title']);
        // verify comment form exists
        $this->assertTextPresent('Leave a Comment');
    }

    ......
}

和编写单元测试一样，我们首先声明了本测试所用到的特定状态（ fixtures）.这里我们指定使用 Post fixture. 在 testShow 测试方法中, 我们首先使用 Selenium RC 打开 URL post/1.注意这是一个相对 URL, 完整的 URL 是拼接了基类中的根URL (i.e. http://localhost/yii/demos/blog/index-test.php/post/1). 然后我们验证是否可以在当前页面中找到sample1 post 的title. 我们还可以验证这个页面是否包含文本 Leave a Comment.

Tip: 在运行功能测试之前, Selenium-RC server 要先启动. 这可以通过在你的Selenium server安装目录下执行命令 java -jar selenium-server.jar 来实现。