单元测试的那点事儿

      作为一个开发人员，必需对自己的代码负责，而一个行之有效的方法就是编写单元测试，虽然说现在的变化很快，可能今天订好的接口，明天就会因为新需求的介入而面临重构的问题，当然这个问题只要软件在发展都是不可避免的事情，所以导致了单元测试的成本升高，而造成很多滞后问题，这就会造成：虽然一直在提倡测试先行，测试驱动的开发模式不能成为长久的行之有效的方案。但是单元测试，果然很重要。

      从Java开发转向PHP（虽然java还没有机会进入公司实践），正是因为PHP的快速开发的特点，很少有机会提及说要记得写单元测试这种话。所以这块就感觉的更加的匮乏，当然也有可能跟我目前的公司开发模式有关系。

     好了话不多说了，进入正题。

     PHP中的单元测试，有一个类库PHPUnit现在最新版本应该有3.5了（我的测试环境：PHP的版本要求5.2.5，pear的版本要求1.9.1，phpunit:3.4.15)，PHPUnit的安装是依赖pear安装的，安装的方式我就不说了，我相信在网上可以找到很多行之有效的方法。

     安装好之后（为了方便我配置了环境），命令行下就可以通过输入 phpunit来查看一些提供的命令和版本信息了。

      其中的几个命令选项如：coverage-开头的是因为我在本机上安装了XDEBUG库出现的，我不的不说xdebug确实是一个很好很棒的工具，能分析代码的性能，也能测试代码覆盖率。xdebug的安装我也不赘述了，google出同样有很多，我之前也有写了一些。

      单元测试说简单也简单，主要涉及到两个类，分别是单元测试类，和单元测试的套件类：（以下实例调试环境为Zend studio 8.0),在使用单元测试之前，你需要将你的单元测试类库包含到你的工程中，右击工程->build IncludePath

1. 单元测试类PHPUnit_Framework_TestCase

创建一个class，继承PHPUnit_Framework_TestCase，

class MyTest extends PHPUnit_Framework_TestCase {

    protected function setUp() {
        parent::setUp();
    }

    protected function tearDown() {
        parent::tearDown();
    }
}

setUp和tearDown分别是每个单元测试方法执行的前置和后置操作。

单元测试的测试方法，都是以test开头进行测试:如：

public function testGetName() {
    $this->assertTrue('myname' == 'myname');
}

public function testGetEmail() {
    $this->assertEquals('myname', 'myname1');
}

      分别写两个测试方法：执行会发现：

       当正确的时候，和在该方法的前面显示一个绿色的钩钩，而如果是失败的方法，则会显示一个红叉叉，而上面的那条状态颜色就会是红色的。

      而如果我这个单元测试类中所有方法都测试通过的时候，则会显示绿色的通行颜色：

单元测试就是这么简单的，对于他里面有啥测试方法，可以查看PHPUnit/frameWork下的testCase类，可以看到很多验证的方法提供，我上面用到的只是其中的两个而已。

   2.  单元测试套件PHPUnit_Framework_TestSuite

      套件，名其曰就是多个测试的集合，可以同时测试多个测试类。

      测试套件有两种写法，两种写法都可以在命令行下运行：

     1）以继承的方式：

      将上面的单元测试做一个套件：

require_once 'PHPUnit\Framework\TestSuite.php';
require_once 'MyTest.php';
class MyTestSuite extends PHPUnit_Framework_TestSuite {

    public function __construct() {
        $this->setName('MyTestSuite');
        $this->addTestSuite('MyTest');
    }

    public static function suite() {
        return new self();
    }
}

      执行：

这种方式也是zend studio创建的时候默认提供的，testSuite中提供的方法就是你的套件的方法了，这个方式通常比较简单。但是对于testSuite中需要很多注意的。这个也可以从他的源代码中看出来，

      2）以调用的方式

       还是将上面的测试类做测试：

require_once('MyTest.php');
class MyTestSuite2 {
    static public function main() {
       PHPUnit_TextUI_TestRunner::run(self::suite());
    }

    static public function suite() {
        $suite = new PHPUnit_Framework_TestSuite('MyTestSuite');
        $suite->addTestSuite('MyTest');
        return $suite;
    }
}

     这种方式在Zend Studio中运行会有问题（我本地测试是这样），但是用命令行运行是可以的：

       说明：命令行下运行：

               .  代表测试方法通过

               I  代表该方法没有实现

               F 代表方法测试失败

               E 代表方法测试有错误输出

通常往一个套件中添加测试方法是通过addTestSuite和addTest两个来完成：实现代码如下：

/**
 * Adds the tests from the given class to the suite.
 *
 * @param mixed $testClass
 * @throws InvalidArgumentException
 */
    public function addTestSuite($testClass)
    {
        if (is_string($testClass) && class_exists($testClass)) {
            $testClass = new ReflectionClass($testClass);
        }

        if (!is_object($testClass)) {
            throw PHPUnit_Util_InvalidArgumentHelper::factory(
              1, 'class name or object'
            );
        }

        if ($testClass instanceof PHPUnit_Framework_TestSuite) {
            $this->addTest($testClass);
        }

        else if ($testClass instanceof ReflectionClass) {
            $suiteMethod = FALSE;

            if (!$testClass->isAbstract()) {
                if ($testClass->hasMethod(PHPUnit_Runner_BaseTestRunner::SUITE_METHODNAME)) {
                    $method = $testClass->getMethod(
                      PHPUnit_Runner_BaseTestRunner::SUITE_METHODNAME
                    );

                    if ($method->isStatic()) {
                        $this->addTest(
                          $method->invoke(NULL, $testClass->getName())
                        );

                        $suiteMethod = TRUE;
                    }
                }
            }

            if (!$suiteMethod && !$testClass->isAbstract()) {
                $this->addTest(new PHPUnit_Framework_TestSuite($testClass));
            }
        }

        else {
            throw new InvalidArgumentException;
        }
    }

通过addTestSuite添加的，应该是一个testSuite或是testCase或是一个类中含有名为suite的静态方法方可。

我们再来看看addTest:

/**
 * Adds a test to the suite.
 *
 * @param PHPUnit_Framework_Test $test
 * @param array $groups
 */
    public function addTest(PHPUnit_Framework_Test $test, $groups = array())
    {
        $class = new ReflectionClass($test);

        if (!$class->isAbstract()) {
            $this->tests[]  = $test;
            $this->numTests = -1;

            if ($test instanceof PHPUnit_Framework_TestSuite &&
                empty($groups)) {
                $groups = $test->getGroups();
            }

            if (empty($groups)) {
                $groups = array('__nogroup__');
            }

            foreach ($groups as $group) {
                if (!isset($this->groups[$group])) {
                    $this->groups[$group] = array($test);
                } else {
                    $this->groups[$group][] = $test;
                }
            }
        }
    }

这个方法就比较简单了，就是从testSuite中拿到注册的test方法。

而对于testSuite的构造方法，对齐传入的参数的规定也是比较复杂：

/**
 * Constructs a new TestSuite:
 *
 * - PHPUnit_Framework_TestSuite() constructs an empty TestSuite.
 *
 * - PHPUnit_Framework_TestSuite(ReflectionClass) constructs a
 * TestSuite from the given class.
 *
 * - PHPUnit_Framework_TestSuite(ReflectionClass, String)
 * constructs a TestSuite from the given class with the given
 * name.
 *
 * - PHPUnit_Framework_TestSuite(String) either constructs a
 * TestSuite from the given class (if the passed string is the
 * name of an existing class) or constructs an empty TestSuite
 * with the given name.
 *
 * @param mixed $theClass
 * @param string $name
 * @throws InvalidArgumentException
 */
    public function __construct($theClass = '', $name = '')
    {
        $argumentsValid = FALSE;

        if (is_object($theClass) &&
            $theClass instanceof ReflectionClass) {
            $argumentsValid = TRUE;
        }

        else if (is_string($theClass) && $theClass !== ''
                 && class_exists($theClass, FALSE)) {
            $argumentsValid = TRUE;

            if ($name == '') {
                $name = $theClass;
            }

            $theClass = new ReflectionClass($theClass);
        }

        else if (is_string($theClass)) {
            $this->setName($theClass);
            return;
        }

        if (!$argumentsValid) {
            throw new InvalidArgumentException;
        }

        $filename = $theClass->getFilename();

        if (strpos($filename, 'eval()') === FALSE) {
            PHPUnit_Util_Filter::addFileToFilter(realpath($filename), 'TESTS');
        }

        if ($name != '') {
            $this->setName($name);
        } else {
            $this->setName($theClass->getName());
        }

        $constructor = $theClass->getConstructor();

        if ($constructor !== NULL &&
            !$constructor->isPublic()) {
            $this->addTest(
              self::warning(
                sprintf(
                  'Class "%s" has no public constructor.',

                  $theClass->getName()
                )
              )
            );

            return;
        }

        $names = array();

        foreach ($theClass->getMethods() as $method) {
            if (strpos($method->getDeclaringClass()->getName(), 'PHPUnit_') !== 0) {
                $this->addTestMethod($theClass, $method, $names);
            }
        }

        if (empty($this->tests)) {
            $this->addTest(
              self::warning(
                sprintf(
                  'No tests found in class "%s".',

                  $theClass->getName()
                )
              )
            );
        }
    }

我的第二种方法也是通过这中构造函数的方式来实现。

好了··就这样··有啥疑问或是纰漏的地方欢迎交流

Technorati 标签: PHPUnitTestCase,PHPUnit_TestSuite,单元测试,单元测试套件,PHP单元厕所,开发