单元测试的那点事儿-CSDN博客

本文链接：https://blog.csdn.net/sinat_41765677/article/details/86160455

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

从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

单元测试类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() 
                ) 
              ) 
            ); 
        } 
    } 
   