Question

我正在开发一个API文档系统，并希望动态检查每个命令是否附加了文档。最简单的方法是动态循环遍历每个命令并检查现有文档以匹配它。

我的代码如下所示：

public function testMissingDocs()
{
    foreach ($aCommands as $sKey => $aOptions)
    {
        $this->assertNotNull($oDocs->get($sKey));
    }
}

这个问题是PHPUnit的StopOnFailure / Error功能，它在第一个断言失败后停止测试。我理解这个功能的原因，我想在大多数测试用例中继续使用它，但对于动态断言/测试，它会让事情变得有点困难。

有没有办法在每次测试的基础上禁用它，以便我可以检查此测试中的每个命令？

Answer 1

您可以使用data provider将单个测试拆分为与命令一样多的测试。

/**
 * @dataProvider getDocsForAllCommands
 */
public function testEveryCommandHasDocs($sKey)
{
    $this->assertNotNull($oDocs->get($sKey));
}

public function getKeysForAllCommands()
{
    return array_keys($aCommands);
}

Answer 2

如果缺少特定类或方法的文档，那将代表该类的问题，而不是检索文档的方法。

尽管将所有文档组合到一个测试中可能更容易，但这并不遵循单元测试最佳实践（因此PHPUnit框架对您而不是对您起作用的原因）。

我建议采用两种方法之一来纠正这个问题：

重构您的测试，以便每个类和/或方法都有自己的文档检查（有几种方法可以run multiple tests in one execution）。
使用诸如PHP_CodeSniffer之类的工具，因为缺少文档可能被视为惯例 - 而不是功能性缺陷。

有没有办法在PHPUnit中关闭特定测试的“Stop On Failure / Error”？

2 个答案: