PHP单元测试利器：PHPUNIT初探

你是否在程序开发的过程中遇到以下的情况：当你花了很长的时间开发一个应用后，你认为应该是大功告成了，可惜在调试的时候，老是不断的发现bug，而且最可怕的是，这些bug是重复出现的，你可能发现这些bug之间会有关联，但却老是找不到问题的所在。

　　当你遇到以上这些令你沮丧的情况时，你一定会想能有什么更好的办法去解决呢?办法当然是有的!这就是使用单元测试。单元测试不但可以在一定程度上解决上述头疼的问题，而且能让代码变的容易维护，还可以能让你更多地对代码进行重构。

　　一旦你编写好单元测试用例，当你需要修改你的代码时，你要做的事情就是重新运行你的单元测试用例并观察这些单元测试用例能否通过，如果通过了的话，证明代码是没问题的。

　　人们往往会说：既然单元测试这么好，为什么那么多人还是不大愿意去写单元测试呢?有以下几种理解上的误曲：

　 　1、认为编写单元测试太浪费时间。虽然目前很多IDE工具都为编写单元测试建立好了框架，但还是要开发者编写一些单元测试的代码的。就象很多开发中的最佳实践一样，用正确的方法去做正确的事情会为开发节省大量的时间。每当新增加新功能时，你可能通过访问你的网页到处去点击手动测试，而运行建立好的单元测试用例其速度其实比通过手工去测试的速度更快。

　　2、认为既然代码能运行了，不需要再编写单元测试。但假设团队中有新的成员，如果没有良好的单元测试用例，新成员很有可能随意地去编码而不考虑各种后果。如果有编写良好的单元测试，在程序运行时进行各种测试，则能最大程度避免bug的产生。

　　3、认为编写单元测试代码枯燥无味。程序员的天性是解决问题，而很多程序员认为在紧张的编码工作时，还要编写单元测试代码，会很枯燥。但要知道的是，如果能通过编写单元测试在很早的阶段就能尽可能发现代码中多的错误的话，那么既节省时间减少了出错，何乐而不为?

　　开始动手安装phpunit

　　本文中将通过介绍php中的单元测试利器phpunit(http://phpunit.de/),并通过实际例子来讲解如何在实际工作中运用phpunit。首先安装phpunit的方法可以通过php下的pear去安装：

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

　　如果你想通过手动方式去安装，可以参考phpunit的手册去安装(http://www.phpunit.de/manual/3.0/en/installation.html)。

　　编写第一个单元测试用例

　　下面我们开始编写第一个单元测试用例。在编写测试用例时，要遵守如下的phpunit的规则：

　　1　一般地，在测试用例中，可以扩展PHPUnit_Framework_TestCase类，这样就可以使用象setUp(),tearDown()等方法了。

　　2 测试用例的名字最好是使用约定俗成的格式，即在被测试类的后面加上”Test”,比如要测试的类为RemoteConnect,则测试用例的命名为RemoteConnectTest。

　 　3 在一个测试用例中的所有的测试方法，在命名时都应该以test+测试方法名去命名，如testDoesLikeWaffles(),要注意的是该方法必须 是声明为public类型的。当然可以在你的测试用例中包含private的方法，但它们不能被phpunit所调用。

　　4 测试方法中是不能接收参数的。

　　下面首先举个简单的例子，代码如下：

<? php
class RemoteConnect
{
   public function connectToServer( $serverName = null )
  {
     if ( $serverName == null ){
       throw new Exception (“That ' s not a server name!”);
    }
    $fp = fsockopen($serverName,80);
    return ($fp) ? true : false;
  }
  public function returnSampleObject()
  {
    return $this;
  }
}
?>

 　　上面的代码其实是实现连接到一个指定的服务器的功能，那么我们可以编写测试代码如下：

<? php
require_once ( ' RemoteConnect.php ' );
class RemoteConnectTest extends PHPUnit_Framework_TestCase
{
   public function setUp(){ }
   public function tearDown(){ }
   public function testConnectionIsValid()
  {
     // test to ensure that the object from an fsockopen is valid
     $connObj = new RemoteConnect();
     $serverName = ' www.google.com ' ;
     $this -> assertTrue( $connObj -> connectToServer( $serverName ) !== false );
  }
}
?>

  　在上面的代码中，由于继承了PHPUnit_Framework_TestCase类，因此在setUp和tearDown方法中，不需要编写任何代码。SetUp方法是在每个测试用例运行前进行一些初始化的工作，而tearDown则在每个测试用例运行后进行一些比如资源的释放等工作。在测试方法中，通过使用phpunit的断言assertTrue去判断所返回的布尔值是否为真，这里是通过调用RemoteConnect.php中的 connectToServe方法去判断能否连接上服务器。

　　接下来我们运行这个单元测试，在命令行下输入代码：

　　phpunit /path/to/tests/RemoteConnectTest.php即可，可以看到测试顺利通过的话，会输出以下结果：

PHPUnit 3.4 by Sebastian Bergmann
.
Time : 1 second
Tests : 1 , Assertions : 1 , Failures 0

 　　可以看到，上面是通过了测试。默认情况下，phpunit是会运行测试用例中的所有测试方法的。下面再介绍下phpunit中相关的几个断言：

AssertTrue / AssertFalse    断言是否为真值还是假
AssertEquals    判断输出是否和预期的相等
AssertGreaterThan    断言结果是否大于某个值，同样的也有LessThan(小于) , GreaterThanOrEqual(大于等于)，LessThanOrEqual(小于等于) .
AssertContains    判断输入是否包含指定的值
AssertType    判断是否属于指定类型
AssertNull    判断是否为空值
AssertFileExists    判断文件是否存在
AssertRegExp    根据正则表达式判断

 　　举个例子来说明下比如AssertType的使用，依然以上面的例子来说，可以用AssertType去判断returnSampleObject返回的对象实例是否为remoteConnect，代码如下：

<? php
function testIsRightObject() {
   $connObj = new RemoteConnect();
   $returnedObject = $connObj -> returnSampleObject();
   $this -> assertType( ' remoteConnect ' , $returnedObject );
}
?>

 　　目前PHP框架对单元测试的支持

　　目前很多优秀的php框架(如Zend Framework,Symfony等)，都提供了对单元测试很好的支持。以Zend Framework为例，说明下其中是如何运行单元测试的。

<? php
class CommentControllerTest extends Zend_Test_PHPUnit_ControllerTestCase
{
   public function setUp()
  {
    parent :: setUp();
  }
   public function tearDown()
  {
    parent :: tearDown();
  }
   public function appBootstrap()
  {
     $this -> frontController -> registerPlugin( new Initializer( ' test ' ));
  }
   public function testGoHome()
  {
     $this -> dispatch( ' /home ' );
     $this -> assertController( ' home ' );
  }
}
?>

  　　以上代码其实是对Zend本身的框架进行了一个单元测试而已，可以看到，在Zend中，是通过继承 Zend_Test_PHPUnit_ControllerTestCase去对Zend的controller去进行单元测试的，可以看到，在zend 中的单元测试跟phpunit中的差不多，但增加了另外一些新的断言，比如上面的assertController,具体的可以参考Zend的参考手册。

　　总结

　　在本文中，初步介绍了单元测试中的一些基础知识和人们常见的误区，并简单举例说明了如何在php中使用phpunit和一些基本的用法，在下一篇文章中，将介绍更多关于phpunit的用法。