B. 標(biāo)注

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

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

Note

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

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