PHPUnit9.0 標(biāo)注-@uses

PHPUnit9.0 標(biāo)注集合

?@uses? 標(biāo)注用來(lái)指明那些將會(huì)在測(cè)試中執(zhí)行到但同時(shí)又不打算讓其被測(cè)試所覆蓋的代碼。在對(duì)代碼單元進(jìn)行測(cè)試時(shí)所必須的值對(duì)象就是個(gè)很好的例子。

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

示例 9.2 展示了另一個(gè)示例。

示例 9.2 指明了要覆蓋的類的測(cè)試類

<?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());
    }
}

在嚴(yán)格覆蓋模式中，意外覆蓋的代碼將導(dǎo)致測(cè)試判定為失敗，這個(gè)標(biāo)注就比較有用，另外它也有助于閱讀代碼。

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