程序師世界是廣大編程愛好者互助、分享、學習的平台,程序師世界有你更精彩!
首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫知識
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
 程式師世界 >> 編程語言 >> 網頁編程 >> PHP編程 >> PHP綜合 >> php系列教程(2):PHP中的注釋 (Comments)

php系列教程(2):PHP中的注釋 (Comments)

編輯:PHP綜合

我們一定要養成良好的編程習慣,給程序注釋可以幫助自己日後修改和閱讀,也可以幫助他人看懂和使用你的代碼。

PHP中的注釋 (Comments) 有兩種類型,一種是單行注釋,一種是多行注釋。

PHP 單行注釋語法

在一行中所有 DE>//DE> 符號右面的文本都被視為注釋, 因為 PHP 解析器忽略該行 DE>//DE> 右面的所有內容。示例如下,紅色字體部分就是單行注釋的內容。

<?PHP
echo "Blabla.cn"; // 這是單行注釋
?>

你也這樣這樣寫,一行只寫注釋,不寫代碼,如下:

<?PHP
// 這是單行注釋
echo "Blabla.cn";
// 這是單行注釋
?>

PHP 多行注釋語法

PHP 多行注釋以 DE>/*DE> 開頭,以 DE>*/DE> 結束。在 DE>/*DE> 和 DE>*/DE> 之間,可以寫多行注釋。

示例如下,紅色部分就是多行注釋的內容。

<?PHP
echo "Blabla.cn";
/*
這是多行注釋
這是多行注釋
*/
?>

4.1 塊注釋

塊注釋通常用於提供對文件,方法,數據結構和算法的描述。塊注釋被置於每個文件的開始處以及每個方法之前。它們也可以被用於其他地方,比如方法內部。在功能和方法內部的塊注釋應該和它們所描述的代碼具有一樣的縮進格式。


塊注釋之首應該有一個空行,用於把塊注釋和代碼分割開來,比如:



/*

* 這裡是塊注釋
*/


塊注釋可以以/*-開頭,這樣indent(1)就可以將之識別為一個代碼塊的開始,而不會重排它。



/*-

* 如果想被忽略,可是使用特別格式的塊注釋
*
* one
*   two
*     three
*/



注意:如果你不使用indent(1),就不必在代碼中使用/*-,或為他人可能對你的代碼運行indent(1)作讓步。

4.2 單行注釋

短注釋可以顯示在一行內,並與其後的代碼具有一樣的縮進層級。如果一個注釋不能在一行內寫完,就該采用塊注釋。單行注釋之前應該有一個空行。以下是一個代碼中單行注釋的例子:



if (condition) {


/* 以下代碼運行的條件 */

...
}


4.3 尾端注釋


極短的注釋可以與它們所要描述的代碼位於同一行,但是應該有足夠的空白來分開代碼和注釋。若有多個短注釋出現於大段代碼中,它們應該具有相同的縮進。


以下是一個代碼中尾端注釋的例子:



if ($a == 2) {

return TRUE; /* 對單一條件的說明 */
} else {
return isPrime($a); /* 其余的條件 */
}


4.4 行末注釋


注釋界定符"//",可以注釋掉整行或者一行中的一部分。它一般不用於連續多行的注釋文本;然而,它可以用來注釋掉連續多行的代碼段。以下是所有三種風格的例子:



if ($foo > 1) {


// 第二種用法.

...
}
else {
return false; // 說明返回值的原因
}

//if ($bar > 1) {

//
//  // 第三種用法
//  ...
//}
//else {
// return false;
//}

4.5 文檔注釋

文檔注釋描述PHP的類、構造器,方法,以及字段(fIEld)。每個文檔注釋都會被置於注釋定界符/**...*/之中,一個注釋對應一個類或成員。該注釋應位於聲明之前:



/**

* 說明這個類的一些 ...
*/
class Example { ...



注意頂層(top-level)的類是不縮進的,而其成員是縮進的。描述類的文檔注釋的第一行(/**)不需縮進;隨後的文檔注釋每行都縮進1格(使星號縱向對齊)。成員,包括構造函數在內,其文檔注釋的第一行縮進4格,隨後每行都縮進5格。


若你想給出有關類、變量或方法的信息,而這些信息又不適合寫在文檔中,則可使用實現塊注釋(見5.1.1)或緊跟在聲明後面的單行注釋(見5.1.2)。例如,有關一個類實現的細節,應放入緊跟在類聲明後面的實現塊注釋中,而不是放在文檔注釋中。


文檔注釋不能放在一個方法或構造器的定義塊中,因為程序會將位於文檔注釋之後的第一個聲明與其相關聯。

  1. 上一頁:
  2. 下一頁:
Copyright © 程式師世界 All Rights Reserved