如何编写行为类似于内置断言的自定义 PHPUnit 断言？

我如何编写自定义断言，例如assertFoo($expected, $actual)，其行为类似于关于错误“堆栈跟踪”的内置断言？

我目前定义了以下方法（在扩展的类中）PHPUnit_Framework_TestCase):

public static function assertFoo($expected, $actual) {
    self::assertEquals($expected, $actual); 
}

如果我从测试中调用它并且测试失败，我会在调用堆栈中得到两项：

1) PreferencesTest::testSignupTeacher
Failed asserting that 5 matches expected 3.

/vagrant/myproject/tests/integration/PreferencesTest.php:17
/vagrant/myproject/tests/integration/PreferencesTest.php:136

17号线是哪里assertFoo()调用内置的assertEquals()并失败； 136号线在那里assertFoo()叫做。

如果我将测试更改为调用assertEquals()直接，我只得到一个：

1) PreferencesTest::testSignupTeacher
Failed asserting that 3 is true.

/vagrant/myproject/tests/integration/PreferencesTest.php:136

有一些手册中的文档 http://www.phpunit.de/manual/current/en/extending-phpunit.html#extending-phpunit.custom-assertions，但似乎没有涵盖这一点。

我对这个问题的第一个猜测（你没有使用其中一个PHPUnit_Framework_Constraint_*物体和self::assertThat）结果完全无关！实际的答案是 phpUnit 有助于从堆栈跟踪中过滤掉其自己代码库中的任何内容，而只将函数留在用户空间中！

执行此操作的代码可以在/path/to/PHPUnit/Util/Filter.php (where /路径/到/ is /usr/共享/php在我的机器上）和感兴趣的功能是getFilteredStacktrace and isFiltered.

如果您想控制此行为，请将您的自定义断言放入派生自的类中PHPUnit_Framework_TestCase，然后从该类派生您的测试。在您的自定义类文件中，在某处调用addFileToFilter，如下所示：

class My_Base_TestCase extends PHPUnit_Framework_TestCase{
  public static function assertFoo($expected, $actual) {
    self::assertEquals($expected, $actual); 
  }
}

PHPUnit_Util_Filter::addFileToFilter(__FILE__, 'DEFAULT');

然后在另一个文件中你有：

class CustomTest extends My_Base_TestCase{

  /** */
  public function testSomething2(){
    $this->assertFoo( 8,  5+4 );
  }
}

它的行为就像内置的assertEquals().

免责声明：这是使用未记录的行为！我将尝试找出该机制是否能够合理地适应未来。