PHP单元测试利器：PHPUNIT初探

开始动手安装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()