很長(zhǎng)時(shí)間里,我對(duì)“你什么時(shí)候會(huì)為PHPUnit寫一個(gè)文檔”這個(gè)問題的回答是:“你不需要PHPUnit文檔,去讀讀JUnit文檔或買一本Junit的書,試一試用PHP和PHPUnit來(lái)重寫Java和Junit的例子”。當(dāng)我和O’Reilly德國(guó)辦公室的Barbara Weiss和Alexandra Follenius這樣說(shuō)的時(shí)候,他們鼓勵(lì)我想想是不是可以寫一本書來(lái)作為PHPUnit的文檔。
PHPUnit可以通過(guò)PHP擴(kuò)展和程序庫(kù)(PEAE)獲得。PEAR是可重用PHP組件的框架和分發(fā)系統(tǒng)。安裝PHPUnit可以通過(guò)PEAR安裝程序命令獲得:
pear install PHPUnit2
根據(jù)PEAR的版本命名標(biāo)準(zhǔn),適用于PHP5的PHPUnit包稱為PHPUnit2。PHPUnit是適用于PHP4的包,這在本書后面關(guān)于“在PHP4中使用PHPUnit”一章會(huì)提到。
安裝只有,能夠在本地的PEAR目錄中找到PHPUnit的源代碼,路徑通常是/usr/lib/ php/PHPUnit2。
盡管使用PEAR安裝程序是PHPUnit支持的安裝方法,但你還是可以手工安裝。要手工安裝,參照以下做法:
1.從http://pear.php.net/package/PHPUnit2/download下載PHPUnit發(fā)布包,然后解壓縮,確保目錄在php.ini定義的include_path中。
2.準(zhǔn)備phpunit腳本
a. 將pear-phpunit腳本改名為phpunit
b. 將腳本中所有的@php_bin@改名為PHP命令行解釋器所在的目錄(通常為/usr/bin/ php)。
c. 將此腳本拷貝到一個(gè)PATH環(huán)境變量所包含的目錄中,并將文件屬性改為可執(zhí)行(chmod +x phpunit)。
3. 將PHPUnit2/ Runner/Version.php腳本中的所有@package_version@字符串替換為你所安裝的PHPUnit版本(如2.3.0)。
PHPUnit命令行測(cè)試工具是通過(guò)phpunit命令調(diào)用的。如下代碼顯示如何通過(guò)PHPUnit命令行測(cè)試工具運(yùn)行測(cè)試。
phpunit ArrayTest
PHPUnit 2.3.0 by Sebastian Bergmann.
Time: 0.067288
OK (2 tests)
對(duì)每個(gè)測(cè)試,PHPUnit命令行測(cè)試工具打印一個(gè)字符表示進(jìn)程:
·測(cè)試成功打印“.”。
·運(yùn)行測(cè)試方法是發(fā)生了斷言失敗打印“F”。
·運(yùn)行測(cè)試方法是發(fā)生了錯(cuò)誤打印“E”。
·測(cè)試沒有完成或測(cè)試沒有實(shí)現(xiàn)打印“I”(見本書后“未完成的測(cè)試”一章)。
PHPUnit可以區(qū)分失敗和錯(cuò)誤。一個(gè)失敗是PHPUnit的斷言違例,錯(cuò)誤是一個(gè)意料外的異;蛞粋(gè)PHP錯(cuò)誤。有時(shí)候這種差別是有用的,因?yàn)殄e(cuò)誤相比失敗更容易修正。如果你有一大串問題列表,好先解決所有錯(cuò)誤,然后看看有沒有失敗遺留下來(lái)。
讓我們看看如下一些代碼命令行測(cè)試工具的選項(xiàng):
phpunit --help
PHPUnit 2.3.0 by Sebastian Bergmann.
Usage: phpunit [switches] UnitTest [UnitTest.php]
--coverage-data <file> Write code-coverage data in raw format to file.
--coverage-html <file> Write code-coverage data in HTML format to file.
--coverage-text <file> Write code-coverage data in text format to file.
--testdox-html <file> Write agile documentation in HTML format to file.
--testdox-text <file> Write agile documentation in Text format to file.
--log-xml <file> Log test progress in XML format to file.
--loader <loader> TestSuiteLoader implementation to use.
--skeleton Generate skeleton UnitTest class for Unit in Unit.php.
--wait Waits for a keystroke after each test.
--help Prints this usage information.
--version Prints the version and exits.
phpunit UnitTest
運(yùn)行類UnitTest提供的測(cè)試,該類應(yīng)該定義在源文件UnitTest.php中。
類UnitTest必須繼承PHPUnit2_Framework_TestCase類,或是提供了公有靜態(tài)方法suite,并返回PHPUnit2_ Framework_Test對(duì)象的類(例如,類PHPUnit2_Framework_TestSuite的一個(gè)實(shí)例)