PHPUnit9.0 標(biāo)注-@covers
PHPUnit9.0 標(biāo)注集合
在測(cè)試代碼中用 ?@covers? 標(biāo)注來(lái)指明想要對(duì)代碼的哪些部分進(jìn)行測(cè)試：
/**
* @covers \BankAccount
*/
public function testBalanceIsInitiallyZero(): void
{
$this->assertSame(0, $this->ba->getBalance());
}如果提供，這將有效地過(guò)濾代碼覆蓋率報(bào)告，將其限制為僅包括所指代碼部分中的已執(zhí)行部分。這將確保代碼只在有針對(duì)它的專(zhuān)用測(cè)試覆蓋的情況下才會(huì)被標(biāo)記為已覆蓋，而如果它被針對(duì)其他類(lèi)的測(cè)試間接使用則并不會(huì)標(biāo)記為已覆蓋，從而避免代碼覆蓋范圍的誤報(bào)。
此標(biāo)注可以添加給測(cè)試類(lèi)的文檔注釋塊，也可以添加給單個(gè)測(cè)試方法的文檔注釋塊。推薦的方法是將此標(biāo)注添加給測(cè)試類(lèi)的文檔注釋塊而不是測(cè)試方法的文檔注釋塊。
如果配置文件中的 ?forceCoversAnnotation配置選項(xiàng)設(shè)置為 ?true?，則每個(gè)測(cè)試方法都必須擁有相應(yīng)的 ?@covers? 標(biāo)注（無(wú)論是在測(cè)試類(lèi)還是單個(gè)測(cè)試方法上）。
表格 2.2 展示了 ?@covers? 標(biāo)注的語(yǔ)法。 指明覆蓋的代碼部分這部分有關(guān)于使用此標(biāo)注的更長(zhǎng)一些的示例。
請(qǐng)注意，此標(biāo)注要求用完全限定類(lèi)名（FQCN，fully-qualified class name）。為了讓讀者更容易理解，推薦寫(xiě)上開(kāi)頭的反斜杠（雖然此標(biāo)注并不要求如此也能正常運(yùn)行）。
表格 2.2 用于指明測(cè)試覆蓋哪些方法的標(biāo)注
| 標(biāo)注 | 描述 |
?@covers ClassName::methodName?（不推薦） |
指明所標(biāo)注的測(cè)試方法覆蓋指定的方法。 |
?@covers ClassName?（推薦） |
指明所標(biāo)注的測(cè)試方法覆蓋給定類(lèi)的全部方法。 |
?@covers ClassName<extended>?（不推薦） |
指明所標(biāo)注的測(cè)試方法覆蓋給定類(lèi)以及其所有父類(lèi)的全部方法。 |
?@covers ClassName::<public>?（不推薦） |
指明所標(biāo)注的測(cè)試方法覆蓋給定類(lèi)的所有 ?public ?方法。 |
?@covers ClassName::<protected>?（不推薦） |
指明所標(biāo)注的測(cè)試方法覆蓋給定類(lèi)的所有 ?protected方法。 |
?@covers ClassName::<private>?（不推薦） |
指明所標(biāo)注的測(cè)試方法覆蓋給定類(lèi)的所有 ?private方法。 |
?@covers ClassName::<!public>?（不推薦） |
指明所標(biāo)注的測(cè)試方法覆蓋給定類(lèi)的所有非 ?public方法。 |
?@covers ClassName::<!protected>?（不推薦） |
指明所標(biāo)注的測(cè)試方法覆蓋給定類(lèi)的所有非 ?protected方法。 |
?@covers ClassName::<!private>?（不推薦） |
指明所標(biāo)注的測(cè)試方法覆蓋給定類(lèi)的所有非 ?private方法。 |
?@covers ::functionName?（推薦） |
指明所標(biāo)注的測(cè)試方法覆蓋給定的全局函數(shù)。 |
更多建議：