PHPUnit9.0 標注集合

?@uses? 標注用來指明那些將會在測試中執(zhí)行到但同時又不打算讓其被測試所覆蓋的代碼。在對代碼單元進行測試時所必須的值對象就是個很好的例子。

/**
 * @covers \BankAccount
 * @uses   \Money
 */
public function testMoneyCanBeDepositedInAccount(): void
{
    // ...
}

示例 9.2 展示了另一個示例。

示例 9.2 指明了要覆蓋的類的測試類

<?php declare(strict_types=1);
use PHPUnit\Framework\TestCase;

/**
 * @covers \Invoice
 * @uses \Money
 */
final class InvoiceTest extends TestCase
{
    private $invoice;

    protected function setUp(): void
    {
        $this->invoice = new Invoice;
    }

    public function testAmountInitiallyIsEmpty(): void
    {
        $this->assertEquals(new Money, $this->invoice->getAmount());
    }
}

在嚴格覆蓋模式中，意外覆蓋的代碼將導致測試判定為失敗，這個標注就比較有用，另外它也有助于閱讀代碼。

請注意，此標注要求用完全限定類名（FQCN，fully-qualified class name）。為了讓讀者更容易理解，推薦寫上開頭的反斜杠（雖然此標注并不要求如此也能正常運行）。