ThinkPHP官网首页

首页

动态

下载

案例

手册

博客

论坛

ENGLISH

Blog

使用单元测试工具

发布时间： 2009-01-13 10:46

敏捷开发思想

首先，编写类定义；
其次，编写测试用例；
第三，实现类；
第四，实现测试用例；
第五，反复测试修改。

[separator]

准备工作

安装PHPUnit

自动安装
pear install phpunit

手动安装
下载http://pear.phpunit.de/get/PHPUnit-3.3.9.tgz，解压到PHP目录，

将pear-phpunit和pear-phpunit.bat，复制到PHP目录，重命名为phpunit和phpunit.bat，将PHP目录加入PATH路径。

编辑phpunit，修改为：

PHP代码
  1. #! php -d safe_mode=Off   
  3. set_include_path(dirname(__FILE__) . DIRECTORY_SEPARATOR . 'PHPUnit-3.3.9' . PATH_SEPARATOR . get_include_path());   
  4.   
  5. require_once 'PHPUnit/Util/Filter.php';   
  6.   
  7. PHPUnit_Util_Filter::addFileToFilter(__FILE__, 'PHPUNIT');   
  8.   
  9. require 'PHPUnit/TextUI/Command.php';   
  10. ?>  


编辑phpunit.bat，假设PHP路径为D:\PHP，修改为：
@echo off
php -d safe_mode=Off D:\PHP\phpunit %*

现在在终端运行phpunit，看看命令参数。

单元测试实践

编写类定义

PHP代码
  2. /**  
  3.  * 计算器类  
  4.  */  
  5. class Calculator   
  6. {   
  7.     /**  
  8.      * 加法运算  
  9.      *  
  10.      * @access public  
  11.      */  
  12.     public function add()   
  13.     {   
  14.     }   
  15.   
  16.     /**  
  17.      * 乘法运算  
  18.      *  
  19.      * @access public  
  20.      */  
  21.     public function multiply()   
  22.     {   
  23.     }   
  24. }   
  25. ?>  

编写测试用例 

PHP代码
  2. require_once 'Calculator.php';   
  3.   
  4. /**  
  5.  * 计算器测试用例  
  6.  */  
  7. class CalculatorTest extends PHPUnit_Framework_TestCase   
  8. {   
  9.     /**  
  10.      * @var    object  
  11.      * @access protected  
  12.      */  
  13.     protected $object;   
  14.   
  15.     /**  
  16.      * 建立测试，在测试方法执行前被调用  
  17.      *  
  18.      * @access protected  
  19.      */  
  20.     protected function setUp()   
  21.     {   
  22.         $this->object = new Calculator();   
  23.     }   
  24.     /**  
  25.      * 拆除测试，在测试方法执行后被调用  
  26.      *  
  27.      * @access protected  
  28.      */  
  29.     protected function tearDown()   
  30.     {   
  31.     }   
  32.   
  33.     /**  
  34.      * 测试加法运算  
  35.      *  
  36.      * @access public  
  37.      */  
  38.     public function testadd()   
  39.     {   
  40.     }   
  41.   
  42.     /**  
  43.      * 测试乘法运算  
  44.      *  
  45.      * @access public  
  46.      */  
  47.     public function testmultiply()   
  48.     {   
  49.     }   
  50. }   
  51. ?>  

实现类 

PHP代码
  2. /**  
  3.  * 计算器类  
  4.  */  
  5. class Calculator   
  6. {   
  7.     /**  
  8.      * 加法运算  
  9.      *  
  10.      * @param  int  $a  
  11.      * @param  int  $b  
  12.      * @access public  
  13.      */  
  14.     public function add($a, $b)   
  15.     {   
  16.         return $a + $b;   
  17.     }   
  18.   
  19.     /**  
  20.      * 乘法运算  
  21.      *  
  22.      * @param  int  $a  
  23.      * @param  int  $b  
  24.      * @access public  
  25.      */  
  26.     public function multiply($a, $b)   
  27.     {   
  28.         return $a * $b;   
  29.     }   
  30. }   
  31. ?>  

实现测试用例 

PHP代码
  2. require_once 'Calculator.php';   
  3.   
  4. /**  
  5.  * 计算器测试用例  
  6.  */  
  7. class CalculatorTest extends PHPUnit_Framework_TestCase   
  8. {   
  9.     /**  
  10.      * @var    object  
  11.      * @access protected  
  12.      */  
  13.     protected $object;   
  14.   
  15.     /**  
  16.      * 建立测试，在测试方法执行前被调用  
  17.      *  
  18.      * @access protected  
  19.      */  
  20.     protected function setUp()   
  21.     {   
  22.         $this->object = new Calculator();   
  23.     }   
  24.   
  25.     /**  
  26.      * 拆除测试，在测试方法执行后被调用  
  27.      *  
  28.      * @access protected  
  29.      */  
  30.     protected function tearDown()   
  31.     {   
  32.     }   
  33.   
  34.     /**  
  35.      * 测试加法运算  
  36.      *  
  37.      * @access public  
  38.      */  
  39.     public function testadd()   
  40.     {   
  41.         $expected = 2;   
  42.         $result = $this->object->add(1, 1);   
  43.         $this->assertEquals($expected, $result);   
  44.     }   
  45.   
  46.     /**  
  47.      * 测试乘法运算  
  48.      *  
  49.      * @access public  
  50.      */  
  51.     public function testmultiply()   
  52.     {   
  53.         $expected = 4;   
  54.         $result = $this->object->multiply(2, 2);   
  55.         $this->assertEquals($expected, $result);   
  56.     }   
  57. }   
  58. ?>  

执行测试
phpunit CalculatorTest.php

进阶

一些方法和属性被声明为保护类型，我们在测试无返回值或被保护的方法时，继承就能解决问题。为什么要测试被保护方法？我个人认为由于PHP是一种语法宽松的语言，因而必须进行更严格的测试，要从最底层确保方法的正确性。如果必要的话，也可以测试私有方法。 

PHP代码
  2. /**  
  3.  * 计算器类  
  4.  */  
  5. class Calculator   
  6. {   
  7.     /**  
  8.      * 加法运算  
  9.      *  
  10.      * @param  int  $a  
  11.      * @param  int  $b  
  12.      * @access protected  
  13.      */  
  14.     protected function add($a, $b)   
  15.     {   
  16.         return $a + $b;   
  17.     }   
  18.   
  19.     /**  
  20.      * 乘法运算  
  21.      *  
  22.      * @param  int  $a  
  23.      * @param  int  $b  
  24.      * @access protected  
  25.      */  
  26.     protected function multiply($a, $b)   
  27.     {   
  28.         return $a * $b;   
  29.     }   
  30. }   
  31. ?>  

使用继承来测试被保护方法。 

PHP代码
  2. require_once 'Calculator.php';   
  3.   
  4. class MyCalculator extends Calculator   
  5. {   
  6. }   
  7.   
  8. /**  
  9.  * 计算器测试用例  
  10.  */  
  11. class CalculatorTest extends PHPUnit_Framework_TestCase   
  12. {   
  13.     /**  
  14.      * @var    object  
  15.      * @access protected  
  16.      */  
  17.     protected $object;   
  18.   
  19.     /**  
  20.      * 建立测试，在测试方法执行前被调用  
  21.      *  
  22.      * @access protected  
  23.      */  
  24.     protected function setUp()   
  25.     {   
  26.         $this->object = new MyCalculator();   
  27.     }   
  28.   
  29.     /**  
  30.      * 拆除测试，在测试方法执行后被调用  
  31.      *  
  32.      * @access protected  
  33.      */  
  34.     protected function tearDown()   
  35.     {   
  36.     }   
  37.   
  38.     /**  
  39.      * 测试加法运算  
  40.      *  
  41.      * @access public  
  42.      */  
  43.     public function testadd()   
  44.     {   
  45.         $expected = 2;   
  46.         $result = $this->object->add(1, 1);   
  47.         $this->assertEquals($expected, $result);   
  48.     }   
  49.   
  50.     /**  
  51.      * 测试乘法运算  
  52.      *  
  53.      * @access public  
  54.      */  
  55.     public function testmultiply()   
  56.     {   
  57.         $expected = 4;   
  58.         $result = $this->object->multiply(2, 2);   
  59.         $this->assertEquals($expected, $result);   
  60.     }   
  61. }   
  62. ?>  

编写总测试套件

PHP代码
  1. <?   
  2. // 设置错误报告为严格等级   
  3. error_reporting(E_ALL | E_STRICT);   
  4.   
  5. // 测试配置文件   
  6. require 'Configure.php';   
  7.   
  8. // Require PHPUnit   
  9. require_once 'PHPUnit/Util/Filter.php';   
  10.   
  11. PHPUnit_Util_Filter::addFileToFilter(__FILE__);   
  12.   
  13. require_once 'PHPUnit/Framework/TestSuite.php';   
  14. require_once 'PHPUnit/Extensions/PhptTestSuite.php';   
  15.   
  16. // Require test suites   
  17. require_once 'Math/AllTests.php';   
  18.   
  19. class AllTests   
  20. {   
  21.     public static function suite()   
  22.     {   
  23.         $suite = new PHPUnit_Framework_TestSuite('MyProject');   
  24.   
  25.         $suite->addTest(Math_AllTests::suite());   
  26.   
  27.         return $suite;   
  28.     }   
  29. }   
  30. ?>  

编写支测试套件

PHP代码
  2. // Require test suites   
  3. require_once 'Math/CalculatorTest.php';   
  4.   
  5. class Math_AllTests   
  6. {   
  7.     public static function suite()   
  8.     {   
  9.         $suite = new PHPUnit_Framework_TestSuite('Math');   
  10.   
  11.         $suite->addTestSuite('Math_CalculatorTest');   
  12.   
  13.         return $suite;   
  14.     }   
  15. }   
  16. ?>  

注意：测试用例这里采用目录名加下划线再加原来的测试用例名，来避免不同目录的同名类冲突问题。

目录结构
Lib
+- Math
   +- Calculator.php
Tests
+- Math
    +- AllTests.php
    +- CalculatorTest.php
|- AllTests.php
|- Configure.php

执行所有测试
phpunit --verbose AllTests.php

备注：phpunit命令可以直接使用不带.php的名称或目录，例如，
phpunit CalculatorTest
phpunit Math
但是这里建议您在每个目录下都写一个测试套件AllTests.php文件，这么做可以为后期测试节省许多时间。因为如果你的项目中有几十个甚至上百个文件或者目录结构很深，将导致PHP脚本超出内存的错误，而且phpunit每次都需要花很长的时间来生成测试套件。

自动化测试

自动生成测试用例
phpunit --skeleton Calculator.php

该命令会生成一个CalculatorTest.php的测试用例，里面有两个未完成的测试方法testAdd()和testMultiply()，你需要完善它。

PHP代码
  2. require_once 'PHPUnit/Framework.php';   
  3.   
  4. require_once 'Calculator.php';   
  5.   
  6. /**  
  7.  * Test class for Calculator.  
  8.  * Generated by PHPUnit on 2009-01-13 at 09:30:46.  
  9.  */  
  10. class CalculatorTest extends PHPUnit_Framework_TestCase   
  11. {   
  12.     /**  
  13.      * @var    Calculator  
  14.      * @access protected  
  15.      */  
  16.     protected $object;   
  17.   
  18.     /**  
  19.      * Sets up the fixture, for example, opens a network connection.  
  20.      * This method is called before a test is executed.  
  21.      *  
  22.      * @access protected  
  23.      */  
  24.     protected function setUp()   
  25.     {   
  26.         $this->object = new Calculator;   
  27.     }   
  28.   
  29.     /**  
  30.      * Tears down the fixture, for example, closes a network connection.  
  31.      * This method is called after a test is executed.  
  32.      *  
  33.      * @access protected  
  34.      */  
  35.     protected function tearDown()   
  36.     {   
  37.     }   
  38.   
  39.     /**  
  40.      * @todo Implement testAdd().  
  41.      */  
  42.     public function testAdd() {   
  43.         // Remove the following lines when you implement this test.   
  44.         $this->markTestIncomplete(   
  45.           'This test has not been implemented yet.'  
  46.         );   
  47.     }   
  48.   
  49.     /**  
  50.      * @todo Implement testMultiply().  
  51.      */  
  52.     public function testMultiply() {   
  53.         // Remove the following lines when you implement this test.   
  54.         $this->markTestIncomplete(   
  55.           'This test has not been implemented yet.'  
  56.         );   
  57.     }   
  58. }   
  59. ?>  

持续集成

如果你需要与其他项目集成或集成到IDE工具中，使用ant构建是个不错的注意。
编写ant构建文件，让构建、测试、报告、清理一部到位。你可以将下面内容加入你的build.xml文件中。

XML/HTML代码
  1. xml version="1.0" encoding="utf-8"?>  
  2. <project name="MyProject" default="test">  
  3.   <property name="docs" location="Docs"/>  
  4.   <property name="report" location="Docs/Report"/>  
  5.   
  6.   <target name="prepare">  
  7.     <mkdir dir="${docs}"/>  
  8.     <mkdir dir="${report}"/>  
  9.   target>  
  10.   
  11.   <target name="test" depends="prepare">  
  12.     <exec dir="${basedir}" executable="phpunit" failonerror="true">  
  13.       <arg line="--log-tap ${docs}/log.txt --log-xml ${docs}/log.xml --testdox-html ${docs}/test.html --testdox-text ${docs}/test.txt AllTests.php"/>  
  14.     exec>  
  15.   target>  
  16.   
  17.   <target name="report" depends="prepare">  
  18.     <exec dir="${basedir}" executable="phpunit" failonerror="true">  
  19.       <arg line="--coverage-html ${report} AllTests.php"/>  
  20.     exec>  
  21.   target>  
  22.   
  23.   <target name="clean">  
  24.     <delete dir="${docs}"/>  
  25.   target>  
  26. project>  

Windows下请将其中的两处 executable="phpunit" 改为 executable="phpunit.bat"。
使用以下命令执行任务：
ant test      执行测试
ant report    生成测试报告
ant clean     清理测试目录

最佳实践

每次编写好类定义后，自动生成测试用例。实现类和测试用例。修改，执行测试，反复重复这个过程。每次修改后，马上修改测试用例，以免之后忘记。

最新动态

    TOPTHINK关于我们友情链接联系我们加入我们捐赠粤ICP备08020157号 Host by易联主机