使用PHPUnit进行单元测试

在开发过程中使用单元测试有助于程序的调试。但是如果像TDD、BDD那样对于每个功能点都要写测试用例又太过于极端了。DHH 说了，TDD 已死。不过对于该测试的还是得测。

首先下载PHPUnit工具： https://phar.phpunit.de/phpunit.phar 。

PHPUnit对应的配置文件为app/phpunit.xml.dist，这是个以.dist能结尾的文件，可能需要将其复制一份到app/phpunit.xml。它配置了一些测试参数，其内容如下：

  1. <?xml version="1.0" encoding="UTF-8"?>
  3. <!-- http://phpunit.de/manual/4.1/en/appendixes.configuration.html -->
  4. <phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  5.          xsi:noNamespaceSchemaLocation="http://schema.phpunit.de/4.1/phpunit.xsd"
  6.          backupGlobals="false"
  7.          colors="true"
  8.          bootstrap="bootstrap.php.cache"
  9. >
  10.     <testsuites>
  11.         <testsuite name="Project Test Suite">
  12.             <directory>../src/*/*Bundle/Tests</directory>
  13.             <directory>../src/*/Bundle/*Bundle/Tests</directory>
  14.         </testsuite>
  15.     </testsuites>
  17.     <!--
  18.     <php>
  19.         <server name="KERNEL_DIR" value="/path/to/your/app/" />
  20.     </php>
  21.     -->
  23.     <filter>
  24.         <whitelist>
  25.             <directory>../src</directory>
  26.             <exclude>
  27.                 <directory>../src/*/*Bundle/Resources</directory>
  28.                 <directory>../src/*/*Bundle/Tests</directory>
  29.                 <directory>../src/*/Bundle/*Bundle/Resources</directory>
  30.                 <directory>../src/*/Bundle/*Bundle/Tests</directory>
  31.             </exclude>
  32.         </whitelist>
  33.     </filter>
  34. </phpunit>

单元测试的目的是独立测试应用程序的个别单元。因此建议单元测试的文件目录结构应与应用程序的一致。例如要测试src/Blogger/BlogBundle/Controller/PageController.php的PageController.php控制器，那么对应的测试文件为src/Blogger/BlogBundle/Tests/Controller/PageControllerTest.php。如下是目录结构示例：

  1. src/Blogger/BlogBundle/
  2.         Entity/
  3.             Blog.php
  4.             Comment.php
  5.         Controller/
  6.             PageController.php
  7.         Twig/
  8.             Extensions/
  9.                 BloggerBlogExtension.php
  10.         Tests/
  11.             Entity/
  12.                 BlogTest.php
  13.                 CommentTest.php
  14.             Controller/
  15.                 PageControllerTest.php
  16.             Twig/
  17.                 Extensions/
  18.                    loggerBlogExtensionTest.php

现在我们对PageCotroller的index方法进行测试，编写测试用例：

  1. // src/Blogger/BlogBundle/Tests/Controller/PageControllerTest.php
  2. class PageControllerTest extends WebTestCase
  3. {
  4.     /**
  5.      * test index page.
  6.      */
  7.     public function testIndex()
  8.     {
  9.         $client = static::createClient();
  11.         $crawler = $client->request('GET', '/');
  13.         $this->assertTrue($crawler->filter('title:contains("symblog")')->count() > 0);
  14.     }
  15. }

然后执行单元测试：

  1. $ phpunit -c app src/Blogger/BlogBundle/Tests/Controller/PageControllerTest.php

这样就可以在代码改动之后通过单元测试来检查当前有没有错误。

关于PHPUnit的使用可以参考它的文档： https://phpunit.de/documentation.html 。