7. 未完成的测试与跳过的测试

    以此来跟踪需要编写的测试。空测试的问题是 PHPUnit 框架会将它们解读为成功。这种错误解读导致错误报告变得毫无用处——无法分辨出测试是真的成功了还是根本就未编写实现。在未实现的测试中调用 同样没啥帮助，因为测试将被解读为失败。这和将未实现的测试解读为成功是一样的错误。

    假如把成功的测试视为绿灯、测试失败视为红灯，那么还额外需要黄灯来将测试标记为未完成或尚未实现。PHPUnit\Framework\IncompleteTest 是一个标记接口，用于将测试方法抛出的异常标记为测试未完成或目前尚未实现而导致的结果。PHPUnit\Framework\IncompleteTestError 是这个接口的标准实现。

    展示了一个测试用例类 SampleTest，它有一个测试方法 testSomething()。通过在测试方法中调用便捷方法 markTestIncomplete()``（会自动抛出一个 ``PHPUnit\Framework\IncompleteTestError 异常）将这个测试标记为未完成。

    示例 7.1 将测试标记为不完整

    1. <?php declare(strict_types=1);
    2. use PHPUnit\Framework\TestCase;
    4. final class SampleTest extends TestCase
    5. {
    6.     public function testSomething(): void
    7.     {
    8.         // 可选：如果愿意，在这里随便测试点什么。
    9.         $this->assertTrue(true, 'This should already work.');
    11.         // 在这里停止，并将此测试标记为未完成。
    12.         $this->markTestIncomplete(
    13.           'This test has not been implemented yet.'
    14.         );
    15.     }

    表格 7.1 列举了用于将测试标记为未完成的 API。

    并非所有测试都能在任何环境中运行。比如说，考虑这样一种情况：一个数据库抽象层，针对其所支持的各种数据库系统有多个不同的驱动程序。针对 MySQL 驱动程序的测试只在 MySQL 服务器可用才能运行。

    展示了一个测试用例类 DatabaseTest，它有一个测试方法 testConnection()。在测试用例类的 setUp() 模板方法中，检查了 MySQLi 扩展是否可用，并且在扩展不可用时用 markTestSkipped() 方法来跳过此测试。

    示例 7.2 跳过测试

    2. use PHPUnit\Framework\TestCase;
    4. final class DatabaseTest extends TestCase
    5. {
    6.     protected function setUp(): void
    7.     {
    8.         if (!extension_loaded('mysqli')) {
    9.             $this->markTestSkipped(
    10.               'The MySQLi extension is not available.'
    11.             );
    12.         }
    13.     }
    15.     public function testConnection(): void
    16.     {
    17.         // ...
    18.     }

    表格 7.2 列举了用于跳过测试的 API。

    除了上述方法，还可以用 @requires 标注来表达测试用例的一些常见前提条件。

    PHP、PHPUnit 和扩展的版本约束支持以下运算符：、<=、>、>=、=、==、!=、<>。

    版本是用 PHP 的 函数进行比较的。除了其他事情之外，这意味着 = 和 == 运算符只能用于完整的 X.Y.Z 版本号，只用 X.Y 是不行的。

    1. <?php declare(strict_types=1);
    2. use PHPUnit\Framework\TestCase;
    4. /**
    5.  * @requires extension mysqli
    6.  */
    7. final class DatabaseTest extends TestCase
    8. {
    9.     /**
    10.      * @requires PHP >= 5.3
    11.      */
    12.     public function testConnection(): void
    13.     {
    14.         // 测试需要 mysqli 扩展，并且要求 PHP >= 5.3
    15.     }
    17.     // ... 其他需要 mysqli 扩展的测试
    18. }

    如果使用了某种在特定版本的 PHP 下无法编译的语法，请参考<testsuites> 元素中 XML 配置信息里关于版本依赖的部分。