«
PHPUnit袖珍指南之命令行测试工具

时间：2008-5-31    作者：Deri    分类： 分享 

   <p>　　PHPUnit命令行测试工具是通过phpunit命令调用的。如下代码显示如何通过PHPUnit命令行测试工具运行测试。</p><code>phpunit ArrayTest<br />PHPUnit 2.3.0 by Sebastian Bergmann.<br />Time: 0.067288<br />OK (2 tests)</code></p><p>　　对每个测试，PHPUnit命令行测试工具打印一个字符表示进程：</p><p>　　・测试成功打印“.”。</p><p>　　・运行测试方法是发生了断言失败打印“F”。</p><p>　　・运行测试方法是发生了错误打印“E”。</p><p>　　・测试没有完成或测试没有实现打印“I”（见本书后“未完成的测试”一章）。</p><p>　　PHPUnit可以区分失败和错误。一个失败是PHPUnit的断言违例，错误是一个意料外的异常或一个PHP错误。有时候这种差别是有用的，因为错误相比失败更容易修正。如果你有一大串问题列表，最好先解决所有错误，然后看看有没有失败遗留下来。</p><p>　　让我们看看如下一些代码命令行测试工具的选项：</p><code>phpunit --help<br />PHPUnit 2.3.0 by Sebastian Bergmann.<br />Usage: phpunit [switches] UnitTest [UnitTest.php]<br />--coverage-data ＜file＞ Write code-coverage data in raw format to file.<br />--coverage-html ＜file＞ Write code-coverage data in HTML format to file.<br />--coverage-text ＜file＞ Write code-coverage data in text format to file.<br />--testdox-html ＜file＞ Write agile documentation in HTML format to file.<br />--testdox-text ＜file＞ Write agile documentation in Text format to file.<br />--log-xml ＜file＞ Log test progress in XML format to file.<br />--loader ＜loader＞ TestSuiteLoader implementation to use.<br />--skeleton Generate skeleton UnitTest class for Unit in Unit.php.<br />--wait Waits for a keystroke after each test.<br />--help Prints this usage information.<br />--version Prints the version and exits.</code></p>
<p> </p>

   <p>　　phpunit UnitTest</p><p>　　运行类UnitTest提供的测试，该类应该定义在源文件UnitTest.php中。</p><p>　　类UnitTest必须继承PHPUnit2_Framework_TestCase类，或是提供了公有静态方法suite，并返回PHPUnit2_ Framework_Test对象的类（例如，类PHPUnit2_Framework_TestSuite的一个实例）</p><p>　　phpunit UnitTest UnitTest.php</p><p>　　运行类UnitTest提供的测试，该类要定义在命令指定的源文件（UnitTest.php）中。</p><p>　　--coverage-data, --coverage-html, and --coverage-text</p><p>　　控制运行测试的代码覆盖信息的分析和集合（参见本书后代码覆盖分析一节）</p><p>　　--testdox-html and --testdox-text</p><p>　　以HTML或普通文本格式生成运行测试的敏捷文档（参见本书后的“测试的其他用途”一章）</p><p>　　--log-xml</p><p>　　生成运行测试的XML格式的日志文件。</p><p>　　下一个例子显示为ArrayTest中的测试生成的XML日志文件。</p><code>＜?xml version="1.0" encoding="UTF-8"?＞<br />＜testsuites＞<br />　＜testsuite name="ArrayTest" tests="2" failures="0" errors="0" time="0.020026"＞<br />　＜testcase name="testNewArrayIsEmpty" class="ArrayTest" time="0.014449"/＞<br />　＜testcase name="testArrayContainsAnElement" class="ArrayTest" time="0.005577"/＞<br />＜/testsuite＞<br />＜/testsuites＞</code></p><p>　　下面的XML日志文件是为名为FailureErrorTest的测试类两个测试生成的，一个是testFailure，一个是testError。这显示了失败和错误是如何分别表示的。</p>
 <p> </p>

   <code>＜?xml version="1.0" encoding="UTF-8"?＞<br />＜testsuites＞<br />　＜testsuite name="FailureErrorTest" tests="2" failures="1" errors="1" time="0.013603"＞<br />　＜testcase name="testFailure" class="FailureErrorTest" time="0.011872"＞<br />　＜failure message="" type="PHPUnit2_Framework_AssertionFailedError"＞＜/failure＞<br />＜/testcase＞<br />＜testcase name="testError" class="FailureErrorTest" time="0.001731"＞<br />　＜error message="" type="Exception"＞＜/error＞<br />＜/testcase＞<br />＜/testsuite＞<br />＜/testsuites＞<br />--loader</code></p><p>　　指定将要使用的测试套件加载器。</p><p>　　标准测试套件加载器会在当前工作目录和PHP的include_path configuration指令定义的路径中寻找源文件。按照PEAR的命名规则，形如Project_Package_Class的类名会映射到的源文件为Project/Package/Class.php。</p><p>　　--skeleton</p><p>　　为类Unit（在文件Unit.php中）生成一个名为UnitTest（在文件UnitTest.php中）的测试用例类的框架。对原始类的每个方法，在生成的测试用例类中提供了一个未完成的测试用例（见本书后的“未完成测试”部分）。</p><p>　　下面的例子显示了如何为一个名为Sample的类生成一个测试类的框架。</p><code>phpunit --skeleton Sample<br />PHPUnit 2.3.0 by Sebastian Bergmann.<br />Wrote test class skeleton for Sample to<br />SampleTest.php.<br />phpunit SampleTest<br />PHPUnit 2.3.0 by Sebastian Bergmann.<br />I<br />Time: 0.007268<br />There was 1 incomplete test case:<br />1) testSampleMethod(SampleTest)<br />OK, but incomplete test cases!!!<br />Tests run: 1, incomplete test cases: 1.</code></p></p><p>　　当你为现有代码书写测试时，你不得不重复很多相同的代码片断，如：</p><code>public function testSampleMethod( ) {}</code></p><p>　　PHPUnit能帮助你分析现有代码，生成测试用例类的框架。</p><p>　　--wait</p><p>　　每个测试结束时，等待一次击键。这很有用，特别是你在一个只有测试一直运行在打开的窗口中运行测试时。</p><p>　　提示 当被测试代码中有PHP语法错误时，文本界面的测试会直接退出，不输出任何错误信息。标准的测试套件加载器会检查测试套件的源文件的PHP语法错误，但是，它不会检查测试套件包含的源文件的语法错误。PHPUnit的未来版本会用在砂箱中PHP解释器类解决这个问题。</p></p>