YII集成了單元測試和功能測試，借助phpunit和selenium實現(xiàn)。筆者在配置過程中遇到了不少麻煩，紀(jì)錄在此。

必要概念
selenium
selenium是個著名的自動化測試工具，可以調(diào)起本地的瀏覽器來完成測試，所以可以用來自動化測試web項目。selenium分為服務(wù)端和客戶端，服務(wù)端使用java開發(fā)，所以需要一個jdk，服務(wù)端在啟動時，會啟動一個http服務(wù)，客戶端通過與服務(wù)端進(jìn)行http通信，向服務(wù)端發(fā)起測試請求，服務(wù)端會自動調(diào)起瀏覽器完成測試。測試人員負(fù)責(zé)編寫客戶端腳本，支持大部分主流的編程語言，當(dāng)然實際上這是由于開源社區(qū)強(qiáng)大的威力，為不同的語言開發(fā)了針對selenium的接口程序而已，服務(wù)端和客戶端之間的協(xié)議筆者并沒有研究，因為這并不重要。

phpunit
phpunit是php語言的測試框架和工具，在進(jìn)行單元測試的時候是使用它的框架，在進(jìn)行功能測試的時候是使用它的工具。基于這個測試框架，有人在此基礎(chǔ)上做了selenium的php接口程序，作為phpunit的擴(kuò)展存在。

YII框架如何集成
Yii在phpunit的基礎(chǔ)上，為測試做了一些簡單的封裝。因此，使用Yii來進(jìn)行測試的時候，需要依賴上述兩者。

環(huán)境安裝
Firefox
selenium-server能夠識別的瀏覽器并不多，似乎是IE和Firefox，所以在OSX上先安裝好Firefox瀏覽器。安裝瀏覽器跟一般的軟件安裝沒有大的區(qū)別，這里不累述了。

JDK
由于selenium-server是使用java開發(fā)的，我們需要先安裝好JDK，百度搜索JDK下載安裝即可。不再累述。

selenium-server
首先來安裝selenium的server版本。在osx下，可以使用brew來安裝，比較方便:

$ brew install selenium-server-standalone

由于selenium-server的源在googleapis上，所以需要翻墻才能進(jìn)行操作，事實上，如果不翻墻，其他步驟也比較困難。

安裝完成后的提示：

To have launchd start selenium-server-standalone at login:  ln -sfv /usr/local/opt/selenium-server-standalone/*.plist ~/Library/LaunchAgentsThen to load selenium-server-standalone now:  launchctl load ~/Library/LaunchAgents/homebrew.mxcl.selenium-server-standalone.plistOr, if you don't want/need launchctl, you can just run:  selenium-server -p 4444

這里明確告訴我們通過如下命令來啟動服務(wù)端

$ selenium-server -p 4444

正如所見，通常selenium-server偵聽4444端口，如果希望修改端口，那么相應(yīng)的Yii處需要修改一下配置。

phpunit
彎路
個人理解，phpunit是一個工具和框架的集合，工具歸工具，框架歸框架。從官網(wǎng)的文檔看，phpunit的工具部分，是以phar包的形式發(fā)布的，而框架部分是通過pear管理的。那么先來記錄一下這兩個概念。沒有興趣的可以跳過這節(jié)。

phar是一種php打包方案。也就是可以把一個php程序或者php網(wǎng)站打包在一起分發(fā)，甚至被作為一個功能模塊調(diào)用。因此，phpunit完全可以將工具程序打包成phar，執(zhí)行phar的時候，通常需要使用php命令。

$ wget https://phar.phpunit.de/phpunit.phar$ chmod +x phpunit.phar$ sudo mv phpunit.phar /usr/local/bin/phpunit$ phpunit --versionPHPUnit x.y.z by Sebastian Bergmann and contributors.

用上面的命令可以下載phpunit的可執(zhí)行文件，可以看到這是個phar包

pear是php擴(kuò)展庫的體系，因為早期php復(fù)用比較困難。編譯型語言由于語法比較緊湊和嚴(yán)謹(jǐn)，比較容易復(fù)用。而php由于靈活多變，復(fù)用起來學(xué)習(xí)成本比較高，于是pear就提出了一個編程規(guī)范和分發(fā)體系來實現(xiàn)php的功能復(fù)用，現(xiàn)在似乎pear已經(jīng)被composer替代了(下面會說)。不過古老的東西既然已經(jīng)走過彎路了不妨記下來。

在mac下可以這么安裝pear：

$ wget http://pear.php.net/go-pear.phar$ sudo php -d detect_unicode=0 go-pear.phar

可以看到，go-pear也是個phar，只不過它是一個安裝pear的php腳本，使用php命令可以執(zhí)行。安裝過程中會提示是否要修改php.ini文件：

WARNING! The include_path defined in the currently used php.ini does notcontain the PEAR PHP directory you just specified:</usr/share/pear>If the specified directory is also not in the include_path used byyour scripts, you will have problems getting any PEAR packages working.Would you like to alter php.ini </etc/php.ini>? [Y/n] : Yphp.ini </etc/php.ini> include_path updated.Current include path      : .:Configured directory      : /usr/share/pearCurrently used php.ini (guess) : /etc/php.iniPress Enter to continue: The 'pear' command is now at your service at /usr/bin/pear** The 'pear' command is not currently in your PATH, so you need to** use '/usr/bin/pear' until you have added** '/usr/bin' to your PATH environment variable.

從這段提示我們可以得知：

pear的可執(zhí)行程序安裝在/usr/bin/pear
pear有個工作目錄是/usr/share/pear，這個工作目錄需要添加到php.ini中，如果讓安裝程序自動添加的話，將是這樣的：

;***** Added by go-pearinclude_path=".:/usr/share/pear";*****

當(dāng)我們在php使用require等包含其他文件的函數(shù)時，php其實除了搜索當(dāng)前目錄，還會搜索include_path。這樣配置就表明，通過pear安裝的程序代碼將存放在工作目錄，而且php能夠找到，默認(rèn)在工作目錄下會有一個System.php，所以以下代碼是可以工作的：

<?php  require 'System.php';?>

使用composer安裝
本來，phpunit可以通過pear來安裝的，然而，時過境遷，在composer大行其道的時代，phpunit也宣布全面支持composer，并且放棄pear，原本通過pear的安裝方式果然都不行了。最后逼不得已，只能上composer(話說包管理工具真是多的十個手指不夠用了，將來有機(jī)會來個橫向比較)。

首先安裝composer，在翻墻狀態(tài)下：

$ brew update$ brew tap josegonzalez/homebrew-php$ brew tap homebrew/versions$ brew install php55-intl$ brew install josegonzalez/php/composer

這樣composer就裝好了。

在項目的根目錄下，創(chuàng)建一個composer.json，寫入：

{  "require-dev": {    "phpunit/phpunit": "4.7.*",    "phpunit/php-invoker": "*",    "phpunit/dbunit": ">=1.2",    "phpunit/phpunit-selenium": ">=1.2",    "phpunit/phpunit-story": "*"  }}

上面的phpunit-selenium就是基于phpunit寫的selenium客戶端庫，詳見文后的參考資料。

然后在項目根目錄下，執(zhí)行

$ sudo composer install

composer會根據(jù)這個composer.json文件在根目錄創(chuàng)建一個vendor目錄，并將依賴的東西全部下載到這個目錄中，其中vendor/bin下面有phpunit的可執(zhí)行文件。

由于是Yii的項目，所以cd到/protected/tests目錄下，執(zhí)行如下命令即可啟動默認(rèn)的SiteTest.php里面的測試方法： (注意在執(zhí)行前，保持selenium-server開啟狀態(tài))

$ ../../vendor/bin/phpunit functional/SiteTest.php

會看到firefox會在執(zhí)行過程中自動啟動，并由如下日志輸出：

PHPUnit 4.7.7 by Sebastian Bergmann and contributors.Warning: Deprecated configuration setting "selenium" used.Time: 11.52 seconds, Memory: 6.50MbOK (1 test, 1 assertion)

phpunit工具程序會自動找到tests/phpunit.xml這個配置文件并根據(jù)此來進(jìn)行某些配置，而Yii會利用phpunit和phpunit-selenium的框架來與selenium-server端通信，server端會啟動瀏覽器，并將日志和結(jié)果等返回給客戶端。整個過程大致就是這樣的。

測試

測試是軟件開發(fā)中必不可少的環(huán)節(jié).無論我們是否意識到,在開發(fā)Web應(yīng)用的時候,我們始終都是在測試的.例如, 當(dāng)我們用PHP寫了一個類時, 我們可能會用到一些注入 echo 或者 die 語句來顯示我們是否正確地實現(xiàn)了某個方法;當(dāng)我們實現(xiàn)了包含一套復(fù)雜的HTML表單的web頁面時, 我們可能會試著輸入一些測試數(shù)據(jù)來確認(rèn)頁面是否是按照我們的預(yù)期來交互的.更高級的開發(fā)者則會寫一些代碼來自動完成這個測試過程, 這樣一來每當(dāng)我們需要測試一些東西的時候, 我們只需要調(diào)用代碼, 剩下來的就交給計算機(jī)了. 這就是所謂的 自動測試, 也是本章的主要話題.

Yii 提供的測試支持包括 單元測試 和 功能測試.

單元測試檢驗了代碼的一個獨(dú)立單元是否按照預(yù)期工作. 在面向?qū)ο缶幊讨? 最基本的代碼單元就是類. 因此, 單元測試的主要職責(zé)就是校驗這個類所實現(xiàn)的每個方法工作都是正常的. 單元測試通常是由開發(fā)了這個類的人來編寫.

功能測試檢驗了特性是否按照預(yù)期工作(如:在一個博客系統(tǒng)里的提交操作).與單元測試相比, 功能測試通常要高級一些, 因為待測試的特性常常牽涉到多個類. 功能測試通常是由非常了解系統(tǒng)需求的人編寫.(這個人既可以是開發(fā)者也可以是質(zhì)量工程師).

測試驅(qū)動開發(fā)

以下展示的便是所謂的 測試驅(qū)動開發(fā) (TDD) 的開發(fā)周期:

• 創(chuàng)建一個涵蓋要實現(xiàn)的特性的新的測試. 測試預(yù)計將在第一次執(zhí)行的時候失敗, 因為特性尚未實現(xiàn).
• 執(zhí)行所有測試,確保這個新的測試是失敗的.
• 編寫代碼來使得測試通過.
• 執(zhí)行所有測試,確保所有測試通過.
• 重構(gòu)新編寫的代碼并確保這些測試仍然能夠通過.
• 重復(fù)步驟1至5推進(jìn)整體功能的實現(xiàn).

構(gòu)建測試環(huán)境

Yii 提供的測試支持需要 PHPUnit 3.5+ 和 Selenium Remote Control 1.0+.請參照他們提供的文檔來安裝 PHPUnit 和 Selenium Remote Control.

當(dāng)我們使用 yiic webapp 控制臺命令來創(chuàng)建一個新的 Yii 應(yīng)用時, 它將會生成以下文件和目錄供我們來編寫和完成測試.

testdrive/
   protected/                包含了受保護(hù)的應(yīng)用文件
      tests/                 包含了應(yīng)用測試
         fixtures/           包含了數(shù)據(jù) fixtures
         functional/         包含了功能測試
         unit/               包含了單元測試
         report/             包含了 coverage 報告
         bootstrap.php       這個腳本在一開始執(zhí)行
         phpunit.xml         PHPUnit 配置文件
         WebTestCase.php     基于 Web 的功能測試基類
如上所示的, 我們的測試代碼主要放在 fixtures, functional 和 unit 這三個目錄下, report 目錄則用于存儲生成的代碼 coverage 報告.

我們可以在控制臺窗口執(zhí)行以下命令來執(zhí)行測試(無論是單元測試還是功能測試):

% cd testdrive/protected/tests% phpunit functional/PostTest.php  // 執(zhí)行單個測試% phpunit --verbose functional    // 執(zhí)行 'functional' 下的所有測試% phpunit --coverage-html ./report unit

上面的最后一條命令將執(zhí)行 unit 目錄下的所有測試然后在 report 目錄下生成出一份 code-coverage 報告. 注意要生成 code-coverage 報告必須安裝并開啟PHP的 xdebug 擴(kuò)展 .

測試的引導(dǎo)腳本

讓我們來看看 bootstrap.php 文件里會有些什么. 首先這個文件有點(diǎn)特殊,因為它看起來很像是 入口腳本, 而它也正是我們執(zhí)行一系列測試的入口.

$yiit='path/to/yii/framework/yiit.php';$config=dirname(__FILE__).'/../config/test.php';require_once($yiit);require_once(dirname(__FILE__).'/WebTestCase.php');Yii::createWebApplication($config);

如上所示, 首先我們包含了來自 Yii 框架的 yiit.php 文件, 它初始化了一些全局常量以及必要的測試基類.然后我們使用 test.php 這個配置文件來創(chuàng)建一個應(yīng)用實例.如果你查看 test.php 文件, 你會發(fā)現(xiàn)它是繼承自 main.php 這個配置文件的, 只不過它多加了一個類名為 [CDbFixtureManager] 的 fixture 應(yīng)用組件.

return CMap::mergeArray( require(dirname(__FILE__).'/main.php'), array( 'components'=>array(  'fixture'=>array(  'class'=>'system.test.CDbFixtureManager',  ),  /* 去除以下注釋可為測試提供一個數(shù)據(jù)庫連接.  'db'=>array(  'connectionString'=>'DSN for test database',  ),  */ ), ));

通過這樣一個啟動腳本, 當(dāng)我們執(zhí)行單元測試時, 我們便可以獲得一個與服務(wù)需求類似的應(yīng)用實例, 而主要的不同就是測試擁有一個 fixture 管理器以及它專屬的測試數(shù)據(jù)庫.

定義特定狀態(tài)(Fixtures)

自動測試需要被執(zhí)行很多次.為了確保測試過程是可以重復(fù)的, 我們很想要在一些可知的狀態(tài)下進(jìn)行測試, 這個狀態(tài)我們稱之為 特定狀態(tài). 舉個例子,在一個博客應(yīng)用中測試文章創(chuàng)建特性, 每次當(dāng)我們進(jìn)行測試時, 與文章相關(guān)的表(例如. Post 表 , Comment 表)應(yīng)該被恢復(fù)到一個特定的狀態(tài)下. PHPUnit 文檔 已經(jīng)很好的描述了一般的特定狀態(tài)的構(gòu)建. 而本節(jié)主要介紹怎樣像剛才描述的例子那樣構(gòu)建數(shù)據(jù)庫特定狀態(tài).

設(shè)置構(gòu)建數(shù)據(jù)庫的特定狀態(tài),這恐怕是測試以數(shù)據(jù)庫為后端支持的應(yīng)用最耗時的部分之一.Yii 引進(jìn)的 [CBbFixtureManager] 應(yīng)用組件可以有效的減輕這一問題.當(dāng)進(jìn)行一組測試的時候,它基本上會做以下這些事情:

在所有測試運(yùn)行之前,它重置測試相關(guān)數(shù)據(jù)為可知的狀態(tài).
在單個測試運(yùn)行之前, 它將特定的表重置為可知狀態(tài).
在一個測試方法執(zhí)行過程中, 它提供了供給特定狀態(tài)的行數(shù)據(jù)的訪問接口.
請按如下使用我們在 應(yīng)用配置 中配置的 [CDbFixtureManager].

return array( 'components'=>array( 'fixture'=>array(  'class'=>'system.test.CDbFixtureManager', ), ),);

然后我們在目錄 protected/tests/fixtures下提供一個特定狀態(tài)數(shù)據(jù). 這個目錄可以通過配置應(yīng)用配置文件中的 [CDbFixtureManager::basePath] 屬性指定為其他目錄.特定狀態(tài)數(shù)據(jù)是由多個稱之為特定狀態(tài)文件的PHP文件組合而成.每個特定狀態(tài)文件返回一個數(shù)組, 代表數(shù)據(jù)的一個特定表的初始行.文件名和表名相同.以下則是將 Post 表的特定狀態(tài)數(shù)據(jù)存儲于名為 Post.php 文件里的例子.

<?phpreturn array( 'sample1'=>array( 'title'=>'test post 1', 'content'=>'test post content 1', 'createTime'=>1230952187, 'authorId'=>1, ), 'sample2'=>array( 'title'=>'test post 2', 'content'=>'test post content 2', 'createTime'=>1230952287, 'authorId'=>1, ),);

正如我們所見, 上面返回了兩行數(shù)據(jù). 每一行都表示一個數(shù)組,其鍵是表的字段名,其值則是對應(yīng)的字段值.每行的索引都是稱之為行別名的字符串(例如: simple1, simple2). 稍后當(dāng)我們編寫測試腳本的時候, 我們可以方便地通過它的別名調(diào)用這行數(shù)據(jù).你也許注意到了我們并未在上述特定狀態(tài)中指定 id 字段的值. 這是因為 id 字段已經(jīng)被定義為自增主鍵了,它的值也會在我們插入新數(shù)據(jù)的時候自動生成.

當(dāng) [CDbFixtureManager] 第一次被引用時, 它會仔細(xì)檢查所有的特定狀態(tài)文件然后使用他們重置對應(yīng)的表.它通過清空表,重置表主鍵的自增序列值,然后插入來自特定狀態(tài)文件的數(shù)據(jù)行到表中來重置表.

有時候,我們可能不想在一套測試前重置特定狀態(tài)文件里描述的每一個表, 因為重置太多的特定狀態(tài)文件可能需要很多時間.這種情況下,我們可以寫一個PHP腳本來定制這個初始化過程.這個腳本應(yīng)該被保存在存放特定狀態(tài)文件的目錄下,并命名為 init.php.當(dāng) [CDbFixtureManager] 檢測到了這個腳本的存在, 它將執(zhí)行這個腳本而不是重置每一個表.

不喜歡使用默認(rèn)方式來重置表也是可以的,例如: 清空表然后插入特定狀態(tài)數(shù)據(jù). 如果是這種情況, 我們可以為指定的特定狀態(tài)文件編寫一個初始化腳本.這個腳本必須名稱為表名+.init.php. 例如: Post 表的初始化腳本文件就是 Post.init.php. 當(dāng) [CDbFixtureManager] 發(fā)現(xiàn)了這個腳本,它將執(zhí)行這個腳本而不是采用默認(rèn)的方式去重置該表.

Tip: 太多的特定狀態(tài)文件大大延長了測試時間.因此, 你應(yīng)該只為那些在測試中數(shù)據(jù)會發(fā)生變化的表提供特定狀態(tài)文件. 那些做為查找服務(wù)的表不會改變,因此不需要特定狀態(tài)文件.