PHP单元测试工具PHPUnit初体验

今天接到了个任务，需要对数字进行计算，因为涉及到整数，小数，和科学计数法等很多条件，所以人工测试非常麻烦，于是想到了PHP的单元测试工具PHPUnit，所以写个文档备查。
看了PHPUnit的文档之后基本有了一些了解，
http://pear.php.net/manual/en/packages.php.phpunit.intro.php
工作流程如下：
1.设计你的class/API
2.创建测试程序集
3.实现class/API
4.运行测试
5.修正测试失败或错误，回到第4步。
我们来举个例子：
下面是你要测试的class，其中formatn函数一个取任意数字的5位有效数字的函数。


CODE: ----------format_number.php-----------
class fo {
      function fo() {
      }
      function formatn($num) {
              $num = rtrim($num,"0");
              $pos = strpos($num,".");
              $num = str_replace(".","",$num);
              $count1 = strlen($num);
              $num = ltrim($num,"0");
              $count2 = strlen($num);
              $zeroc = $count1 - $count2;
              $num = substr($num,0,6);
              $num = round($num/10);
              //$num = str_pad($num, 5, "0");
              if ($pos !== false) {
                      $num = str_pad($num, (strlen($num)+$zeroc), "0", STR_PAD_LEFT);
                      $dotl = substr($num,0,$pos);
                      $dotr = substr($num,$pos);
                      $num = $dotl.".".$dotr;
              }
              return $num;
      }
}接着创建TestCase，继承自PHPUnit_TestCase
CODE: ----------testcase.php-----------
require_once 'format_number.php';
require_once 'PHPUnit.php';
class foTest extends PHPUnit_TestCase {
      //这个成员变量是存放要测试的类引用
      var $abc;
      //构造函数
      function foTest($name) {
              $this->;PHPUnit_TestCase($name);
      }
      //new一个要测试的类为成员变量abc赋值
      function setUp() {
              $this->;abc = new fo;
      }
      //unset要测试的类
      function tearDown() {
              unset($this->;abc);
      }
      //自定义的testcase
      function testFormatn1() {
              //调用要测试的类的方法，结果放到$result变量
              $result = $this->;abc->;formatn("100.234");
              //期望结果
              $expected = "100.23";
              //判断是否相等，这里使用assertTrue方法来判断布而值是否为true。
              $this->;assertTrue($result == $expected);
      }
      function testFormatn2() {
              $result = $this->;abc->;formatn("0.100234");
              $expected = "0.10023";
              $this->;assertTrue($result == $expected);
      }
      function testFormatn3() {
              $result = $this->;abc->;formatn("0.100235");
              $expected = "0.10024";
              $this->;assertTrue($result == $expected);
      }
      function testFormatn4() {
              $result = $this->;abc->;formatn("0.000100235");
              $expected = "0.00010024";
              $this->;assertTrue($result == $expected);
      }
      function testFormatn5() {
              $result = $this->;abc->;formatn("0.000100232");
              $expected = "0.00010023";
              $this->;assertTrue($result == $expected);
      }
      function testFormatn6() {
              $result = $this->;abc->;formatn("1343");
              $expected = "1343";
              $this->;assertTrue($result == $expected);
      }
      function testFormatn7() {
              $result = $this->;abc->;formatn("1343.01");
              $expected = "1343";
              $this->;assertTrue($result == $expected);
      }
      function testFormatn8() {
              $result = $this->;abc->;formatn("1343.05");
              $expected = "1343.1";
              $this->;assertTrue($result == $expected);
      }
      function testFormatn9() {
              $result = $this->;abc->;formatn("0");
              $expected = "0";
              $this->;assertTrue($result == $expected);
      }
      function testFormatn10() {
              $result = $this->;abc->;formatn("105.2342");
              $expected = "105.23";
              $this->;assertTrue($result == $expected);
      }
      function testFormatn11() {
              $result = $this->;abc->;formatn("105.2375");
              $expected = "105.24";
              $this->;assertTrue($result == $expected);
      }
      function testFormatn12() {
              $result = $this->;abc->;formatn("0.000523751");
              $expected = "0.00052375";
              $this->;assertTrue($result == $expected);
      }
      function testFormatn13() {
              $result = $this->;abc->;formatn("0.000523755");
              $expected = "0.00052376";
              $this->;assertTrue($result == $expected);
      }
}最后还需要一个运行测试的程序
CODE: ----------runtest.php-----------
require_once 'testcase.php';
require_once 'PHPUnit.php';
$suite = new PHPUnit_TestSuite("foTest");
$result = PHPUnit::run($suite);
echo $result->;toString();
?>;现在就可以通过命令行运行这个testcase
php runtest.php
得到结果如下：
CODE: TestCase foTest->;testFormatn1() passed
TestCase foTest->;testFormatn2() passed
TestCase foTest->;testFormatn3() passed
TestCase foTest->;testFormatn4() passed
TestCase foTest->;testFormatn5() passed
TestCase foTest->;testFormatn7() passed
TestCase foTest->;testFormatn8() passed
TestCase foTest->;testFormatn9() passed
TestCase foTest->;testFormatn10() passed
TestCase foTest->;testFormatn11() passed
TestCase foTest->;testFormatn12() passed
TestCase foTest->;testFormatn13() passed
TestCase foTest->;testFormatn6() failed: expected TRUE, actual FALSE其中testFormatn6的测试失败，
我们就可以去检查一下我们的代码在什么地方出问题了。
补充一点
也可以把assertTrue方法换assertEquals，如下：
CODE:         function testFormatn6() {
              $result = $this->;abc->;formatn("1343");
              $expected = "1343";
              $this->;assertEquals($expected, $result);
      }如果失败得到对应的结果会直观一些（可以显示错误的结果）：
CODE: TestCase foTest->;testFormatn8() failed: expected 1343 , actual 134.

http://developer.51cto.com/art/200809/87882.htm 

PHP单元测试工具phpunit安装(windows版)

简述：本程序是经过本人测试后才发布上来的，这样减少误差。

环境：

        php5.2.9-2，

        apach2.2.11.

        windows xp

1 安装pear  

1) 安装前的工作 安装PHP后所产生的文件夹下面有一个go-pear.bat文件

(我的php环境D:wampinphpphp5.2.9-2) 2) 执行installer 双击go-pear.bat，有问答时 用y，然后Enter，其它全部按“Enter” 3) 追加路径 打开你的php.ini文件，在 ; Paths and Directories ; （我的路径D:wampinphpphp5.2.9-2PEAR） 下面看一下有没有"include-path="，没有就追加，有的话就加写pear include-path=".;C:PHP;C:PHPsmartylibs; D:wampinphpphp5.2.9-2PEAR" 4) 查看PHP文件夹 除了go-pear.bat文件，又多了pear.bat和PEAR_ENV.reg 5) 注册表的修改 双击PEAR_ENV.reg文件，选择“ok”，即可完成修改 6) 环境参数的自动设定 双击pear.bat文件即可 7) 确认安装成功与否 打开运行cmd，cd D:wampinphpphp5.2.9-2

输入 "pear version" 

      显示版本为1.7.2

输入“pear list”看安装在文件夹pear下面library是否都显示出来了

如果没有Benchmark 

请加入 pear install Benchmark 

2 pear升级

pear upgrade pear   （更新pear） 显示版本为1.9.4

比原来版本高吧，表示升级成功。

3 安装phpunit

pear channel-discover pear.phpunit.de pear channel-discover components.ez.no pear channel-discover pear.symfony-project.com

pear install --alldeps phpunit/PHPUnit[安装PHPUnit的所有元素] (pear install phpunit/PHPUnit只安装一部分文件，之后会报错，解决方法删掉php/pear/phpunit,再执行pear install --alldeps phpunit/PHPUnit)

测试是否安装成功:

   phpunit --version 看到版本信息了吗，哈哈，恭喜，表示安装成功！

头一次使用这种东西，开始有些手忙脚乱，弄了二天了，终于有点眉目了，记录一下过程。

　　以下都是在windows下进行，我的php版本是php-5.1.4-win32

　　因为phpunit要通过pear安装，所以首先要安装pear

　　找到php的目录下有一个go-pear.bat，双击运行，提示你安装系统级别的还是一个本地拷贝，直接回车，定制安装目录，选择默认即可，直接回车。程序会自动从网站上下载所需要的文件，过一会就提示你安装好了。

　　安装好pear后，在php的目录下发现有一个pear.bat，这个是pear安装包用的程序，

　　在命令行进行php目录，输入 pear install phpunit2

　　即可，安装完成。

　　在php目录下会生成一个phpunit.bat，这个是命令行下的测试命令。

　　我们可以把他复制到我们要测试程序的目录下面。

　　在命令行下输入 phpunit sampleTest

　　就是对sampleTest这个case进行测试了。

　　有二点需要注意的地方:

　　phpunit需要pear的benchmark包，所以要安装 pear install benchmark即可。

　　在windows下安装完成后还不能直接进行测试，运行测试程序时会出现 'php'不是内部或外部命令，也不是可运行的程序。的错误，经我一路跟踪，最后在PHPUnit2/Util/Fileloader.php这个文件里找到了问题所在，这个文件是载入测试文件用的，同时使用php解释器进行了语法检查，shell_exec('php -l ' . escapeshellarg($filename));，而我的php.exe并没有在系统的path中，所以出现了上述问题，一种办法是将$output到include之前的代码全部注释掉，这样就不用语法检查了，还有一种办法就是在系统path中加入php的安装目录。

 三、--------------------

搞单元测试的大概步骤是：编写待测试类，编写测试用例类，编写测试类，测试。

单元测试首先就是要安装测试的类库了，用pear安装PHPUnit，window下这样操作，首先安装pear，在pear下发现phpunit的频道pear channel-discover pear.phpunit.de，然后安装之pear install phpunit/PHPUnit（使用这条指令，将不会完全安装PHPUnit的所有元素，请使用pear install --alldepsphpunit/PHPUnit），这时在phppear会有PHPUnit.php和PHPUnit文件夹，这样就安装好了。

首先编写待测试类，这里用一个计算器作为例子，计算器类为代码一：

 
class calculator{ 
    function add($p1,$p2) 
    { 
        return $p1+$p2; 
    } 
} 

编写测试用例类，这个类引入了PHPUnit.php和待测试的计算器类，然后初始化待测试类，编写断言。
 
    require_once("c8-2.php"); 
    require_once("PHPUnit.php"); 

    class calculatorTest extends PHPUnit_TestCase 
    { 
        public $o; 
        //开始的时候初始化一个待测试类 
        function setUp() 
        { 
            $this->o = new calculator(); 
        } 
        //最后消亡的时候清除掉这个类 
        function tearDown() { 
                unset($this->o); 
        } 
        function testadd() 
        { 
            $r = $this->o->add(1,2); 
            $e = 5; 
            //assertEquals和assertTrue基本一样，不过这个返回的参数更加详细 
            //这里的1+2肯定等于3，我们故意写错看下他的反应。注意这里是故意写错，实际测试时，这些结果必须是完全正确的，因为它的功能就是检测类方法是否正确。 
            $this->assertEquals($r,$e); 
        } 
        function testadd2() 
        { 
            $r = $this->o->add(102,106); 
            $e = 208; 
            $this->assertTrue($r == $e); 
        } 
         
    } 

最后编写测试类，不编写这个类也可以，在命令行下直接跑phpunitcalculatorTest就行。

 
    require_once("testc8-2.php"); 
    require_once("PHPUnit.php"); 
    //载入测试用例 
    $s = new PHPUnit_TestSuite("calculatorTest"); 
    //测试 
    $r = PHPUnit::run($s); 
    //测试结果 
    echo $r->toString(); 
    //print_r($r); 

跑一边这个测试类就可以了，它输出了测试用例中所有的测试结果。如果你有多个类，多个测试类的test类，那么可以编写一个AllTests套件。包含所有的待测试的测试类，然后在phpunit下统一执行就行。这个类可能是这样的：

<?php  
require_once 'PHPUnit/Framework.php'; 
require_once 'PHPUnit/TextUI/TestRunner.php';//这里引入了这个文件 

require_once 'DemoTest.php';  //引入了两个测试类
require_once 'calculatortest.php'; 

class AllTests { 
public static function main() { 
PHPUnit_TextUI_TestRunner::run(self::suite()); 
} 

public static function suite() { 
$suite = new PHPUnit_Framework_TestSuite('Zend Framework - Zend'); 
$suite->addTestSuite('DemoTest'); //最佳测试类
$suite->addTestSuite('calculatortest'); 
return $suite; 
} 
}