php中的注釋包括哪些
php中的注釋包括哪些？讓小編一一為大家整理出來吧！希望對大家有所幫助！
PHP 單行注釋語法
在一行中所有 DE>/pic/pic/p>
<?php
echo "Blabla.cn"; /pic/p>
?>
你也這樣這樣寫，一行只寫注釋，不
寫代碼，如下：
<?php
/pic/p>
echo "Blabla.cn";
/pic/p>
?>
PHP 多行注釋語法
PHP 多行注釋以 DE>/*DE> 開頭，以 DE>*/DE> 結(jié)束。在 DE>/*DE> 和 DE>*/DE> 之間，可以寫多行注釋。
示例如下，紅色部分就是多行注釋的內(nèi)容。
<?php
echo "Blabla.cn";
/*
這是多行注釋
這是多行注釋
*/
?>
4.1 塊注釋
塊注釋通常用于提供對文件，方法，數(shù)據(jù)結(jié)構(gòu)和算法的描述。塊注釋被置于每個文件的開始處以及每個方法之前。它們也可以被用于其他地方，比如方法內(nèi)部。在功能和方法內(nèi)部的塊注釋應(yīng)該和它們所描述的代碼具有一樣的縮進(jìn)格式。
塊注釋之首應(yīng)該有一個空行，用于把塊注釋和代碼分割開來，比如：
/*
* 這里是塊注釋
*/
塊注釋可以以/*-開頭，這樣indent(1)就可以將之識別為一個代碼塊的開始，而不會重排它。
/*-
* 如果想被忽略，可是使用特別格式的塊注釋
*
* one
* two
* three
*/
注意：如果你不使用indent(1)，就不必在代碼中使用/*-，或為他人可能對你的代碼運行indent(1)作讓步。
4.2 單行注釋
短注釋可以顯示在一行內(nèi)，并與其后的代碼具有一樣的縮進(jìn)層級。如果一個注釋不能在一行內(nèi)寫完，就該采用塊注釋。單行注釋之前應(yīng)該有一個空行。以下是一個代碼中單行注釋的例子：
if (condition) {
/* 以下代碼運行的條件 */
...
}
4.3 尾端注釋
極短的注釋可以與它們所要描述的代碼位于同一行，但是應(yīng)該有足夠的空白來分開代碼和注釋。若有多個短注釋出現(xiàn)于大段代碼中，它們應(yīng)該具有相同的縮進(jìn)。
以下是一個代碼中尾端注釋的例子：
if ($a == 2) {
return TRUE; /* 對單一條件的說明 */
} else {
return isPrime($a); /* 其余的條件 */
}
4.4 行末注釋
注釋界定符"/pic/p>
if ($foo > 1) {
/pic/p>
...
}
else {
return false; /pic/p>
}
/pic/p>
/pic/p>
/pic/pic/strong>
/pic/strong>
/pic/p>
/pic/p>
/pic/p>
/pic/p>
4.5 文檔注釋
文檔注釋描述php的類、構(gòu)造器，方法，以及字段(field)。每個文檔注釋都會被置于注釋定界符/**...*/之中，一個注釋對應(yīng)一個類或成員。該注釋應(yīng)位于聲明之前：
/**
* 說明這個類的一些 ...
*/
class Example { ...
注意頂層(top-level)的類是不縮進(jìn)的，而其成員是縮進(jìn)的。描述類的文檔注釋的第一行(/**)不需縮進(jìn)；隨后的文檔注釋每行都縮進(jìn)1格(使星號縱向?qū)R)。成員，包括構(gòu)造函數(shù)在內(nèi)，其文檔注釋的第一行縮進(jìn)4格，隨后每行都縮進(jìn)5格。
若你想給出有關(guān)類、變量或方法的信息，而這些信息又不適合寫在文檔中，則可使用實現(xiàn)塊注釋(見5.1.1)或緊跟在聲明后面的單行注釋(見5.1.2)。例如，有關(guān)一個類實現(xiàn)的細(xì)節(jié)，應(yīng)放入緊跟在類聲明后面的實現(xiàn)塊注釋中，而不是放在文檔注釋中。
【php中的注釋包括哪些】相關(guān)文章：
php正則去掉php注釋09-25
PHP 7.1 中的重大更新有哪些11-15
PHP 7.1中都有哪些重大更新12-01
在PHP中操作MySQL要注意哪些問題12-21
PHP 7.1中有哪些重大的更新10-30
2017年基金季報中應(yīng)包括哪些內(nèi)容08-07
php語言的主要特點中包括10-28