附錄?B.?標(biāo)注

所謂標(biāo)注，是指某些編程語言中允許加在源代碼中的一種特殊格式的語法元數(shù)據(jù)。PHP 并沒有專門的語言特性來支持對源代碼進(jìn)行標(biāo)注，然而 PHP 社區(qū)早已經(jīng)形成慣例，通過在文檔注釋塊中使用諸如 @annotation arguments 這樣的標(biāo)簽來為源代碼加上標(biāo)注。在 PHP 中，文檔注釋塊是可反射的：可以對函數(shù)、方法、類以及屬性調(diào)用相應(yīng)級別的反射 API getDocComment() 方法來獲取相應(yīng)的文檔注釋塊。諸如 PHPUnit 這樣的應(yīng)用程序在運(yùn)行時(shí)用這些信息來配置其行為。

Note

PHP中的文檔注釋塊必須以 /** 開頭，以 */ 結(jié)尾。任何其他形式的注釋中出現(xiàn)的標(biāo)注都將被忽略。

本附錄列出了 PHPUnit 所支持的所有標(biāo)注種類。