php標準注釋

2022-03-23 20:22:50 字數 1309 閱讀 4852

檔案頭部模板

[php]view plain

copy

print

?/** 

*這是乙個什麼檔案 

* *此檔案程式用來做什麼的(詳細說明,可選。)。 

* @author      richard

* @version     $id$ 

* @since        1.0 

*/  

函式頭部注釋

[php]view plain

copy

print

?/** 

* some_func  

* 函式的含義說明 

* * @access public 

* @param mixed $arg1 引數一的說明 

* @param mixed $arg2 引數二的說明 

* @param mixed $mixed 這是乙個混合型別 

* @since 1.0 

* @return array 

*/  

public function thisisfunction($string, $integer, $mixed)   

類的注釋

[php]view plain

copy

print

?/** 

* 類的介紹 

* * 類的詳細介紹(可選。)。 

* @author         richard

* @since          1.0 

*/  

class test   

程式**注釋

1. 注釋的原則是將問題解釋清楚,並不是越多越好。

2. 若干語句作為乙個邏輯**塊,這個塊的注釋可以使用/* */方式。

3. 具體到某乙個語句的注釋,可以使用行尾注釋://。

[php]view plain

copy

print

?/* 生成配置檔案、資料檔案。*/  

$this->setconfig();  

$this->createconfigfile();  //建立配置檔案  

$this->clearcache();         // 清除快取檔案  

$this->createdatafiles();   // 生成資料檔案  

$this->prepareproxys();  

$this->restart();  

php注釋標準

4.1 塊注釋 塊注釋通常用於提供對檔案,方法,資料結構和演算法的描述。塊注釋被置於每個檔案的開始處以及每個方法之前。它們也可以被用於其他地方,比如方法內部。在功能和方法內部的塊注釋應該和它們所描述的 具有一樣的縮排格式。塊注釋之首應該有乙個空行,用於把塊注釋和 分割開來,比如 這裡是塊注釋 塊注釋...

PHP標準注釋

php是一門及其容易入門的語言,剛入門的新手不到幾分鐘的時間可能就會用echo列印出乙個hello world 但是他是真正的程式設計師嗎?怎麼來定義程式設計師呢?如果想真正成為乙個程式設計師,那麼就必須遵循一套程式書寫規範,我們經常編寫一些函式,但是這些函式可能也只有自己能看得懂,甚至過一段時間自...

PHP標準注釋

2018 12 14 14 08 網頁設計 標籤 php 425 2 php是一門及其容易入門的語言,剛入門的新手不到幾分鐘的時間可能就會用echo列印出乙個hello world 但是他是真正的程式設計師嗎?怎麼來定義程式設計師呢?如果想真正成為乙個程式設計師,那麼就必須遵循一套程式書寫規範。我們...