第 2 章 编写 PHPUnit 测试

例 2.1展示了如何用 PHPUnit 编写测试来对 PHP 数组操作进行测试。本例介绍了用 PHPUnit 编写测试的基本惯例与步骤：

  • 针对类 Class 的测试写在类 ClassTest中。

  • ClassTest（通常）继承自 PHPUnit_Framework_TestCase。

  • 测试都是命名为 test* 的公用方法。

也可以在方法的文档注释块(docblock)中使用 @test 标注将其标记为测试方法。

  • 在测试方法内，类似于 assertEquals()（参见 附录 A）这样的断言方法用来对实际值与预期值的匹配做出断言。


例 2.1: 用 PHPUnit 测试数组操作

  1. <?php
  2. class StackTest extends PHPUnit_Framework_TestCase
  3. {
  4.     public function testPushAndPop()
  5.     {
  6.         $stack = array();
  7.         $this->assertEquals(0, count($stack));
  8.  
  9.         array_push($stack, 'foo');
  10.         $this->assertEquals('foo', $stack[count($stack)-1]);
  11.         $this->assertEquals(1, count($stack));
  12.  
  13.         $this->assertEquals('foo', array_pop($stack));
  14.         $this->assertEquals(0, count($stack));
  15.     }
  16. }
  17. ?>

| |
当你想把一些东西写到 print 语句或者调试表达式中时，别这么做，将其写成一个测试来代替。
|
| |—Martin Fowler

测试的依赖关系

| |
单元测试主要是作为一种良好实践来编写的，它能帮助开发人员识别并修复 bug、重构代码，还可以看作被测软件单元的文档。要实现这些好处，理想的单元测试应当覆盖程序中所有可能的路径。一个单元测试通常覆盖一个函数或方法中的一个特定路径。但是，测试方法并不一定非要是一个封装良好的独立实体。测试方法之间经常有隐含的依赖关系暗藏在测试的实现方案中。
|
| |—Adrian Kuhn et. al.

PHPUnit支持对测试方法之间的显式依赖关系进行声明。这种依赖关系并不是定义在测试方法的执行顺序中，而是允许生产者(producer)返回一个测试基境(fixture)的实例，并将此实例传递给依赖于它的消费者(consumer)们。

  • 生产者(producer)，是能生成被测单元并将其作为返回值的测试方法。

  • 消费者(consumer)，是依赖于一个或多个生产者及其返回值的测试方法。

例 2.2展示了如何用 @depends 标注来表达测试方法之间的依赖关系。


例 2.2: 用 @depends 标注来表达依赖关系

  1. <?php
  2. class StackTest extends PHPUnit_Framework_TestCase
  3. {
  4.     public function testEmpty()
  5.     {
  6.         $stack = array();
  7.         $this->assertEmpty($stack);
  8.  
  9.         return $stack;
  10.     }
  11.  
  12.     /**
  13.      * @depends testEmpty
  14.      */
  15.     public function testPush(array $stack)
  16.     {
  17.         array_push($stack, 'foo');
  18.         $this->assertEquals('foo', $stack[count($stack)-1]);
  19.         $this->assertNotEmpty($stack);
  20.  
  21.         return $stack;
  22.     }
  23.  
  24.     /**
  25.      * @depends testPush
  26.      */
  27.     public function testPop(array $stack)
  28.     {
  29.         $this->assertEquals('foo', array_pop($stack));
  30.         $this->assertEmpty($stack);
  31.     }
  32. }
  33. ?>

在上例中，第一个测试， testEmpty()，创建了一个新数组，并断言其为空。随后，此测试将此基境作为结果返回。第二个测试，testPush()，依赖于 testEmpty() ，并将所依赖的测试之结果作为参数传入。最后，testPop() 依赖于 testPush()。

为了快速定位缺陷，我们希望把注意力集中于相关的失败测试上。这就是为什么当某个测试所依赖的测试失败时，PHPUnit 会跳过这个测试。通过利用测试之间的依赖关系，缺陷定位得到了改进，如例 2.3中所示。


例 2.3: 利用测试之间的依赖关系

  1. <?php
  2. class DependencyFailureTest extends PHPUnit_Framework_TestCase
  3. {
  4.     public function testOne()
  5.     {
  6.         $this->assertTrue(FALSE);
  7.     }
  8.  
  9.     /**
  10.      * @depends testOne
  11.      */
  12.     public function testTwo()
  13.     {
  14.     }
  15. }
  16. ?>
  1. phpunit --verbose DependencyFailureTest
  2. PHPUnit 4.8.0 by Sebastian Bergmann and contributors.
  3.  
  4. FS
  5.  
  6. Time: 0 seconds, Memory: 5.00Mb
  7.  
  8. There was 1 failure:
  9.  
  10. 1) DependencyFailureTest::testOne
  11. Failed asserting that false is true.
  12.  
  13. /home/sb/DependencyFailureTest.php:6
  14.  
  15. There was 1 skipped test:
  16.  
  17. 1) DependencyFailureTest::testTwo
  18. This test depends on "DependencyFailureTest::testOne" to pass.
  19.  
  20.  
  21. FAILURES!
  22. Tests: 1, Assertions: 1, Failures: 1, Skipped: 1.

测试可以使用多个 @depends 标注。PHPUnit 不会更改测试的运行顺序，因此你需要自行保证某个测试所依赖的所有测试均出现于这个测试之前。

拥有多个 @depends 标注的测试，其第一个参数是第一个生产者提供的基境，第二个参数是第二个生产者提供的基境，以此类推。参见例 2.4


例 2.4: 有多重依赖的测试

  1. <?php
  2. class MultipleDependenciesTest extends PHPUnit_Framework_TestCase
  3. {
  4.     public function testProducerFirst()
  5.     {
  6.         $this->assertTrue(true);
  7.         return 'first';
  8.     }
  9.  
  10.     public function testProducerSecond()
  11.     {
  12.         $this->assertTrue(true);
  13.         return 'second';
  14.     }
  15.  
  16.     /**
  17.      * @depends testProducerFirst
  18.      * @depends testProducerSecond
  19.      */
  20.     public function testConsumer()
  21.     {
  22.         $this->assertEquals(
  23.             array('first', 'second'),
  24.             func_get_args()
  25.         );
  26.     }
  27. }
  28. ?>
  1. phpunit --verbose MultipleDependenciesTest
  2. PHPUnit 4.8.0 by Sebastian Bergmann and contributors.
  3.  
  4. ...
  5.  
  6. Time: 0 seconds, Memory: 3.25Mb
  7.  
  8. OK (3 tests, 3 assertions)

数据供给器

测试方法可以接受任意参数。这些参数由数据供给器方法（在 例 2.5中，是 additionProvider() 方法）提供。用 @dataProvider 标注来指定使用哪个数据供给器方法。

数据供给器方法必须声明为 public，其返回值要么是一个数组，其每个元素也是数组；要么是一个实现了 Iterator 接口的对象，在对它进行迭代时每步产生一个数组。每个数组都是测试数据集的一部分，将以它的内容作为参数来调用测试方法。


例 2.5: 使用返回数组的数组的数据供给器

  1. <?php
  2. class DataTest extends PHPUnit_Framework_TestCase
  3. {
  4.     /**
  5.      * @dataProvider additionProvider
  6.      */
  7.     public function testAdd($a, $b, $expected)
  8.     {
  9.         $this->assertEquals($expected, $a + $b);
  10.     }
  11.  
  12.     public function additionProvider()
  13.     {
  14.         return array(
  15.           array(0, 0, 0),
  16.           array(0, 1, 1),
  17.           array(1, 0, 1),
  18.           array(1, 1, 3)
  19.         );
  20.     }
  21. }
  22. ?>
  1. phpunit DataTest
  2. PHPUnit 4.8.0 by Sebastian Bergmann and contributors.
  3.  
  4. ...F
  5.  
  6. Time: 0 seconds, Memory: 5.75Mb
  7.  
  8. There was 1 failure:
  9.  
  10. 1) DataTest::testAdd with data set #3 (1, 1, 3)
  11. Failed asserting that 2 matches expected 3.
  12.  
  13. /home/sb/DataTest.php:9
  14.  
  15. FAILURES!
  16. Tests: 4, Assertions: 4, Failures: 1.

当使用到大量数据集时，最好逐个用字符串键名对其命名，避免用默认的数字键名。这样输出信息会更加详细些，其中将包含打断测试的数据集所对应的名称。


例 2.6: 使用带有命名数据集的数据供给器

  1. <?php
  2. class DataTest extends PHPUnit_Framework_TestCase
  3. {
  4.     /**
  5.      * @dataProvider additionProvider
  6.      */
  7.     public function testAdd($a, $b, $expected)
  8.     {
  9.         $this->assertEquals($expected, $a + $b);
  10.     }
  11.  
  12.     public function additionProvider()
  13.     {
  14.         return array(
  15.           'adding zeros' => array(0, 0, 0),
  16.           'zero plus one' => array(0, 1, 1),
  17.           'one plus zero' => array(1, 0, 1),
  18.           'one plus one' => array(1, 1, 3)
  19.         );
  20.     }
  21. }
  22. ?>
  1. phpunit DataTest
  2. PHPUnit 4.8.0 by Sebastian Bergmann and contributors.
  3.  
  4. ...F
  5.  
  6. Time: 0 seconds, Memory: 5.75Mb
  7.  
  8. There was 1 failure:
  9.  
  10. 1) DataTest::testAdd with data set "one plus one" (1, 1, 3)
  11. Failed asserting that 2 matches expected 3.
  12.  
  13. /home/sb/DataTest.php:9
  14.  
  15. FAILURES!
  16. Tests: 4, Assertions: 4, Failures: 1.


例 2.7: 使用返回迭代器对象的数据供给器

  1. <?php
  2. require 'CsvFileIterator.php';
  3.  
  4. class DataTest extends PHPUnit_Framework_TestCase
  5. {
  6.     /**
  7.      * @dataProvider additionProvider
  8.      */
  9.     public function testAdd($a, $b, $expected)
  10.     {
  11.         $this->assertEquals($expected, $a + $b);
  12.     }
  13.  
  14.     public function additionProvider()
  15.     {
  16.         return new CsvFileIterator('data.csv');
  17.     }
  18. }
  19. ?>
  1. phpunit DataTest
  2. PHPUnit 4.8.0 by Sebastian Bergmann and contributors.
  3.  
  4. ...F
  5.  
  6. Time: 0 seconds, Memory: 5.75Mb
  7.  
  8. There was 1 failure:
  9.  
  10. 1) DataTest::testAdd with data set #3 ('1', '1', '3')
  11. Failed asserting that 2 matches expected '3'.
  12.  
  13. /home/sb/DataTest.php:11
  14.  
  15. FAILURES!
  16. Tests: 4, Assertions: 4, Failures: 1.


例 2.8: CsvFileIterator 类

  1. <?php
  2. class CsvFileIterator implements Iterator {
  3.     protected $file;
  4.     protected $key = 0;
  5.     protected $current;
  6.  
  7.     public function __construct($file) {
  8.         $this->file = fopen($file, 'r');
  9.     }
  10.  
  11.     public function __destruct() {
  12.         fclose($this->file);
  13.     }
  14.  
  15.     public function rewind() {
  16.         rewind($this->file);
  17.         $this->current = fgetcsv($this->file);
  18.         $this->key = 0;
  19.     }
  20.  
  21.     public function valid() {
  22.         return !feof($this->file);
  23.     }
  24.  
  25.     public function key() {
  26.         return $this->key;
  27.     }
  28.  
  29.     public function current() {
  30.         return $this->current;
  31.     }
  32.  
  33.     public function next() {
  34.         $this->current = fgetcsv($this->file);
  35.         $this->key++;
  36.     }
  37. }
  38. ?>

如果测试同时从 @dataProvider 方法和一个或多个 @depends 测试接收数据，那么来自于数据供给器的参数将先于来自所依赖的测试的。来自于所依赖的测试的参数对于每个数据集都是一样的。参见例 2.9


例 2.9: 在同一个测试中组合使用 @depends 和 @dataProvider

  1. <?php
  2. class DependencyAndDataProviderComboTest extends PHPUnit_Framework_TestCase
  3. {
  4.     public function provider()
  5.     {
  6.         return array(array('provider1'), array('provider2'));
  7.     }
  8.  
  9.     public function testProducerFirst()
  10.     {
  11.         $this->assertTrue(true);
  12.         return 'first';
  13.     }
  14.  
  15.     public function testProducerSecond()
  16.     {
  17.         $this->assertTrue(true);
  18.         return 'second';
  19.     }
  20.  
  21.     /**
  22.      * @depends testProducerFirst
  23.      * @depends testProducerSecond
  24.      * @dataProvider provider
  25.      */
  26.     public function testConsumer()
  27.     {
  28.         $this->assertEquals(
  29.             array('provider1', 'first', 'second'),
  30.             func_get_args()
  31.         );
  32.     }
  33. }
  34. ?>
  1. phpunit --verbose DependencyAndDataProviderComboTest
  2. PHPUnit 4.8.0 by Sebastian Bergmann and contributors.
  3.  
  4. ...F
  5.  
  6. Time: 0 seconds, Memory: 3.50Mb
  7.  
  8. There was 1 failure:
  9.  
  10. 1) DependencyAndDataProviderComboTest::testConsumer with data set #1 ('provider2')
  11. Failed asserting that two arrays are equal.
  12. --- Expected
  13. +++ Actual
  14. @@ @@
  15. Array (
  16. -    0 => 'provider1'
  17. +    0 => 'provider2'
  18. 1 => 'first'
  19. 2 => 'second'
  20. )
  21.  
  22. /home/sb/DependencyAndDataProviderComboTest.php:31
  23.  
  24. FAILURES!
  25. Tests: 4, Assertions: 4, Failures: 1.

注意

如果一个测试依赖于另外一个使用了数据供给器的测试，仅当被依赖的测试至少能在一组数据上成功时，依赖于它的测试才会运行。使用了数据供给器的测试，其运行结果是无法注入到依赖于此测试的其他测试中的。

注意

所有的数据供给器方法的执行都是在对 setUpBeforeClass 静态方法的调用和第一次对 setUp 方法的调用之前完成的。因此，无法在数据供给器中使用创建于这两个方法内的变量。这是必须的，这样 PHPUnit 才能计算测试的总数量。

对异常进行测试

例 2.10展示了如何用 @expectedException 标注来测试被测代码中是否抛出了异常。


例 2.10: 使用 @expectedException 标注

  1. <?php
  2. class ExceptionTest extends PHPUnit_Framework_TestCase
  3. {
  4.     /**
  5.      * @expectedException InvalidArgumentException
  6.      */
  7.     public function testException()
  8.     {
  9.     }
  10. }
  11. ?>
  1. phpunit ExceptionTest
  2. PHPUnit 4.8.0 by Sebastian Bergmann and contributors.
  3.  
  4. F
  5.  
  6. Time: 0 seconds, Memory: 4.75Mb
  7.  
  8. There was 1 failure:
  9.  
  10. 1) ExceptionTest::testException
  11. Expected exception InvalidArgumentException
  12.  
  13.  
  14. FAILURES!
  15. Tests: 1, Assertions: 1, Failures: 1.

另外，你可以将 @expectedExceptionMessage、@expectedExceptionMessageRegExp 和 @expectedExceptionCode 与 @expectedException 联合使用，来对异常的讯息与代号进行测试，如例 2.11所示。


例 2.11: 使用 @expectedExceptionMessage、@expectedExceptionMessageRegExp 和 @expectedExceptionCode 标注

  1. <?php
  2. class ExceptionTest extends PHPUnit_Framework_TestCase
  3. {
  4.     /**
  5.      * @expectedException        InvalidArgumentException
  6.      * @expectedExceptionMessage Right Message
  7.      */
  8.     public function testExceptionHasRightMessage()
  9.     {
  10.         throw new InvalidArgumentException('Some Message', 10);
  11.     }
  12.  
  13.     /**
  14.      * @expectedException              InvalidArgumentException
  15.      * @expectedExceptionMessageRegExp #Right.*#
  16.      */
  17.     public function testExceptionMessageMatchesRegExp()
  18.     {
  19.         throw new InvalidArgumentException('Some Message', 10);
  20.     }
  21.  
  22.     /**
  23.      * @expectedException     InvalidArgumentException
  24.      * @expectedExceptionCode 20
  25.      */
  26.     public function testExceptionHasRightCode()
  27.     {
  28.         throw new InvalidArgumentException('Some Message', 10);
  29.     }
  30. }
  31. ?>
  1. phpunit ExceptionTest
  2. PHPUnit 4.8.0 by Sebastian Bergmann and contributors.
  3.  
  4. FFF
  5.  
  6. Time: 0 seconds, Memory: 3.00Mb
  7.  
  8. There were 3 failures:
  9.  
  10. 1) ExceptionTest::testExceptionHasRightMessage
  11. Failed asserting that exception message 'Some Message' contains 'Right Message'.
  12.  
  13. 2) ExceptionTest::testExceptionMessageMatchesRegExp
  14. Failed asserting that exception message 'Some Message' matches '#Right.*#'.
  15.  
  16. 3) ExceptionTest::testExceptionHasRightCode
  17. Failed asserting that expected exception code 20 is equal to 10.
  18.  
  19.  
  20. FAILURES!
  21. Tests: 3, Assertions: 6, Failures: 3.

关于 @expectedExceptionMessage、@expectedExceptionMessageRegExp 和 @expectedExceptionCode，分别在“@expectedExceptionMessage”一节、“@expectedExceptionMessageRegExp”一节 和 “@expectedExceptionCode”一节有更多相关范例。

此外，还可以用 setExpectedException() 或 setExpectedExceptionRegExp() 方法来设定所预期的异常，如例 2.12所示。


例 2.12: 预期被测代码将引发异常

  1. <?php
  2. class ExceptionTest extends PHPUnit_Framework_TestCase
  3. {
  4.     public function testException()
  5.     {
  6.         $this->setExpectedException('InvalidArgumentException');
  7.     }
  8.  
  9.     public function testExceptionHasRightMessage()
  10.     {
  11.         $this->setExpectedException(
  12.           'InvalidArgumentException', 'Right Message'
  13.         );
  14.         throw new InvalidArgumentException('Some Message', 10);
  15.     }
  16.  
  17.     public function testExceptionMessageMatchesRegExp()
  18.     {
  19.         $this->setExpectedExceptionRegExp(
  20.           'InvalidArgumentException', '/Right.*/', 10
  21.         );
  22.         throw new InvalidArgumentException('The Wrong Message', 10);
  23.     }
  24.  
  25.     public function testExceptionHasRightCode()
  26.     {
  27.         $this->setExpectedException(
  28.           'InvalidArgumentException', 'Right Message', 20
  29.         );
  30.         throw new InvalidArgumentException('The Right Message', 10);
  31.     }
  32. }
  33. ?>
  1. phpunit ExceptionTest
  2. PHPUnit 4.8.0 by Sebastian Bergmann and contributors.
  3.  
  4. FFFF
  5.  
  6. Time: 0 seconds, Memory: 3.00Mb
  7.  
  8. There were 4 failures:
  9.  
  10. 1) ExceptionTest::testException
  11. Expected exception InvalidArgumentException
  12.  
  13. 2) ExceptionTest::testExceptionHasRightMessage
  14. Failed asserting that exception message 'Some Message' contains 'Right Message'.
  15.  
  16. 3) ExceptionTest::testExceptionMessageMatchesRegExp
  17. Failed asserting that exception message 'The Wrong Message' contains '/Right.*/'.
  18.  
  19. 4) ExceptionTest::testExceptionHasRightCode
  20. Failed asserting that expected exception code 20 is equal to 10.
  21.  
  22.  
  23. FAILURES!
  24. Tests: 4, Assertions: 8, Failures: 4.

表 2.1中列举了用于对异常进行测试的各种方法。


表 2.1. 用于对异常进行测试的方法

方法 含义
void setExpectedException(string $exceptionName[, string $exceptionMessage = '', integer $exceptionCode = NULL]) 设定预期的 $exceptionName、$exceptionMessage 和 $exceptionCode。
void setExpectedExceptionRegExp(string $exceptionName[, string $exceptionMessageRegExp = '', integer $exceptionCode = NULL]) 设定预期的 $exceptionName、$exceptionMessageRegExp 和 $exceptionCode。
String getExpectedException() 返回预期异常的名称。

可以用 例 2.13 中所示方法来对异常进行测试。


例 2.13: 另一种对异常进行测试的方法

  1. <?php
  2. class ExceptionTest extends PHPUnit_Framework_TestCase {
  3.     public function testException() {
  4.         try {
  5.             // ... 预期会引发异常的代码 ...
  6.         }
  7.  
  8.         catch (InvalidArgumentException $expected) {
  9.             return;
  10.         }
  11.  
  12.         $this->fail('预期的异常未出现。');
  13.     }
  14. }
  15. ?>

当例 2.13 中预期会引发异常的代码并没有引发异常时，后面对 fail() 的调用将会中止测试，并通告测试有问题。如果预期的异常出现了，将执行 catch 代码块，测试将会成功结束。

对 PHP 错误进行测试

默认情况下，PHPUnit 将测试在执行中触发的 PHP 错误、警告、通知都转换为异常。利用这些异常，就可以，比如说，预期测试将触发 PHP 错误，如例 2.14所示。

注意

PHP 的 error_reporting 运行时配置会对 PHPUnit 将哪些错误转换为异常有所限制。如果在这个特性上碰到问题，请确认 PHP 的配置中没有抑制想要测试的错误类型。


例 2.14: 用 @expectedException 来预期 PHP 错误

  1. <?php
  2. class ExpectedErrorTest extends PHPUnit_Framework_TestCase
  3. {
  4.     /**
  5.      * @expectedException PHPUnit_Framework_Error
  6.      */
  7.     public function testFailingInclude()
  8.     {
  9.         include 'not_existing_file.php';
  10.     }
  11. }
  12. ?>
  1. phpunit -d error_reporting=2 ExpectedErrorTest
  2. PHPUnit 4.8.0 by Sebastian Bergmann and contributors.
  3.  
  4. .
  5.  
  6. Time: 0 seconds, Memory: 5.25Mb
  7.  
  8. OK (1 test, 1 assertion)

PHPUnit_Framework_Error_Notice 和 PHPUnit_Framework_Error_Warning 分别代表 PHP 通知与 PHP 警告。

注意

对异常进行测试是越明确越好的。对太笼统的类进行测试有可能导致不良副作用。因此，不再允许用 @expectedException 或 setExpectedException() 对 Exception 类进行测试。

如果测试依靠会触发错误的 PHP 函数，例如 fopen ，有时候在测试中使用错误抑制符会很有用。通过抑制住错误通知，就能对返回值进行检查，否则错误通知将会导致抛出 PHPUnit_Framework_Error_Notice。


例 2.15: 对会引发PHP 错误的代码的返回值进行测试

  1. <?php
  2. class ErrorSuppressionTest extends PHPUnit_Framework_TestCase
  3. {
  4.     public function testFileWriting() {
  5.         $writer = new FileWriter;
  6.         $this->assertFalse(@$writer->write('/is-not-writeable/file', 'stuff'));
  7.     }
  8. }
  9. class FileWriter
  10. {
  11.     public function write($file, $content) {
  12.         $file = fopen($file, 'w');
  13.         if($file == false) {
  14.             return false;
  15.         }
  16.         // ...
  17.     }
  18. }
  19.  
  20. ?>
  1. phpunit ErrorSuppressionTest
  2. PHPUnit 4.8.0 by Sebastian Bergmann and contributors.
  3.  
  4. .
  5.  
  6. Time: 1 seconds, Memory: 5.25Mb
  7.  
  8. OK (1 test, 1 assertion)

如果不使用错误抑制符，此测试将会失败，并报告 fopen(/is-not-writeable/file): failed to open stream: No such file or directory。

对输出进行测试

有时候，想要断言（比如说）某方法的运行过程中生成了预期的输出（例如，通过 echo 或 print）。PHPUnit_Framework_TestCase 类使用 PHP 的 输出缓冲 特性来为此提供必要的功能支持。

例 2.16展示了如何用 expectOutputString() 方法来设定所预期的输出。如果没有产生预期的输出，测试将计为失败。


例 2.16: 对函数或方法的输出进行测试

  1. <?php
  2. class OutputTest extends PHPUnit_Framework_TestCase
  3. {
  4.     public function testExpectFooActualFoo()
  5.     {
  6.         $this->expectOutputString('foo');
  7.         print 'foo';
  8.     }
  9.  
  10.     public function testExpectBarActualBaz()
  11.     {
  12.         $this->expectOutputString('bar');
  13.         print 'baz';
  14.     }
  15. }
  16. ?>
  1. phpunit OutputTest
  2. PHPUnit 4.8.0 by Sebastian Bergmann and contributors.
  3.  
  4. .F
  5.  
  6. Time: 0 seconds, Memory: 5.75Mb
  7.  
  8. There was 1 failure:
  9.  
  10. 1) OutputTest::testExpectBarActualBaz
  11. Failed asserting that two strings are equal.
  12. --- Expected
  13. +++ Actual
  14. @@ @@
  15. -'bar'
  16. +'baz'
  17.  
  18.  
  19. FAILURES!
  20. Tests: 2, Assertions: 2, Failures: 1.

表 2.2中列举了用于对输出进行测试的各种方法。


表 2.2. 用于对输出进行测试的方法

方法 含义
void expectOutputRegex(string $regularExpression) 设置输出预期为输出应当匹配正则表达式 $regularExpression。
void expectOutputString(string $expectedString) 设置输出预期为输出应当与 $expectedString 字符串相等。
bool setOutputCallback(callable $callback) 设置回调函数，用来做诸如将实际输出规范化之类的动作。
string getActualOutput() 获取实际输出。

注意

在严格模式下，本身产生输出的测试将会失败。

错误相关信息的输出

当有测试失败时，PHPUnit 全力提供尽可能多的有助于找出问题所在的上下文信息。


例 2.17: 数组比较失败时生成的错误相关信息输出

  1. <?php
  2. class ArrayDiffTest extends PHPUnit_Framework_TestCase
  3. {
  4.     public function testEquality() {
  5.         $this->assertEquals(
  6.             array(1,2,3 ,4,5,6),
  7.             array(1,2,33,4,5,6)
  8.         );
  9.     }
  10. }
  11. ?>
  1. phpunit ArrayDiffTest
  2. PHPUnit 4.8.0 by Sebastian Bergmann and contributors.
  3.  
  4. F
  5.  
  6. Time: 0 seconds, Memory: 5.25Mb
  7.  
  8. There was 1 failure:
  9.  
  10. 1) ArrayDiffTest::testEquality
  11. Failed asserting that two arrays are equal.
  12. --- Expected
  13. +++ Actual
  14. @@ @@
  15.  Array (
  16.      0 => 1
  17.      1 => 2
  18. -    2 => 3
  19. +    2 => 33
  20.      3 => 4
  21.      4 => 5
  22.      5 => 6
  23.  )
  24.  
  25. /home/sb/ArrayDiffTest.php:7
  26.  
  27. FAILURES!
  28. Tests: 1, Assertions: 1, Failures: 1.

在这个例子中，数组中只有一个值不同，但其他值也都同时显示出来，以提供关于错误发生的位置的上下文信息。

当生成的输出很长而难以阅读时，PHPUnit 将对其进行分割，并在每个差异附近提供少数几行上下文信息。


例 2.18: 长数组比较失败时生成的错误相关信息输出

  1. <?php
  2. class LongArrayDiffTest extends PHPUnit_Framework_TestCase
  3. {
  4.     public function testEquality() {
  5.         $this->assertEquals(
  6.             array(0,0,0,0,0,0,0,0,0,0,0,0,1,2,3 ,4,5,6),
  7.             array(0,0,0,0,0,0,0,0,0,0,0,0,1,2,33,4,5,6)
  8.         );
  9.     }
  10. }
  11. ?>
  1. phpunit LongArrayDiffTest
  2. PHPUnit 4.8.0 by Sebastian Bergmann and contributors.
  3.  
  4. F
  5.  
  6. Time: 0 seconds, Memory: 5.25Mb
  7.  
  8. There was 1 failure:
  9.  
  10. 1) LongArrayDiffTest::testEquality
  11. Failed asserting that two arrays are equal.
  12. --- Expected
  13. +++ Actual
  14. @@ @@
  15.      13 => 2
  16. -    14 => 3
  17. +    14 => 33
  18.      15 => 4
  19.      16 => 5
  20.      17 => 6
  21.  )
  22.  
  23.  
  24. /home/sb/LongArrayDiffTest.php:7
  25.  
  26. FAILURES!
  27. Tests: 1, Assertions: 1, Failures: 1.

边缘情况

当比较失败时，PHPUnit 为输入值建立文本表示，然后以此进行对比。这种实现导致在差异指示中显示出来的问题可能比实际上存在的多。

这种情况只出现在对数组或者对象使用 assertEquals 或其他“弱”比较函数时。


例 2.19: 当使用弱比较时在生成的差异结果中出现的边缘情况

  1. <?php
  2. class ArrayWeakComparisonTest extends PHPUnit_Framework_TestCase
  3. {
  4.     public function testEquality() {
  5.         $this->assertEquals(
  6.             array(1  ,2,3 ,4,5,6),
  7.             array('1',2,33,4,5,6)
  8.         );
  9.     }
  10. }
  11. ?>
  1. phpunit ArrayWeakComparisonTest
  2. PHPUnit 4.8.0 by Sebastian Bergmann and contributors.
  3.  
  4. F
  5.  
  6. Time: 0 seconds, Memory: 5.25Mb
  7.  
  8. There was 1 failure:
  9.  
  10. 1) ArrayWeakComparisonTest::testEquality
  11. Failed asserting that two arrays are equal.
  12. --- Expected
  13. +++ Actual
  14. @@ @@
  15.  Array (
  16. -    0 => 1
  17. +    0 => '1'
  18.      1 => 2
  19. -    2 => 3
  20. +    2 => 33
  21.      3 => 4
  22.      4 => 5
  23.      5 => 6
  24.  )
  25.  
  26.  
  27. /home/sb/ArrayWeakComparisonTest.php:7
  28.  
  29. FAILURES!
  30. Tests: 1, Assertions: 1, Failures: 1.

在这个例子中，第一个索引项中的 1 and '1' 在报告中被视为不同，虽然 assertEquals 认为这两个值是匹配的。

原文: http://www.phpunit.cn/manual/4.8/zh_cn/writing-tests-for-phpunit.html