欧美日韩精品在线,国内精品久久久久久久久,一级毛片恃级毛片直播,清纯唯美亚洲综合欧美色

解析PHP編碼規(guī)范之注釋和文件結(jié)構(gòu)_PHP教程

編輯Tag賺U幣
教程Tag:暫無Tag,歡迎添加,賺取U幣!

推薦:解答PHP和MySQL操作應(yīng)該注意的一些細(xì)節(jié)
對于 MySQL ,第一件你必須牢記的是它的每一行命令都是用分號 (;) 作為結(jié)束的,但沒有完全絕對的事,在這兒也是一樣。 當(dāng)一行 MySQL 被插入在 PHP 代碼中時(shí),最好把后面的分號省略掉,例如: mysql_query (INSERT INTO tablename (first_name, last_name) V

文件結(jié)構(gòu)

|

|――images

|――include

|――parameter

|――config

|――function

|――index

images存放圖片文件,include中是系統(tǒng)是要引用的文件,一般在parameter中存放參數(shù)文件,config中存放配置文件,function中存放方法文件,如javascript的方法等,并按功能模塊的分類,將各功能的類也放入其中

文件名

文件夾命名一般采用英文,長度一般不超過20個(gè)字符,命名采用小寫字母。除特殊情況才使用中文拼音,一些常見的文件夾命名如:images(存放圖形文件),flash(存放Flash文件),style(存放CSS文件),scripts(存放Javascript腳本),inc(存放include文件),link(存放友情鏈接),media(存放多媒體文件)等。文件名稱統(tǒng)一用小寫的英文字母、數(shù)字和下劃線的組合。

塊注釋

塊注釋通常用于提供對文件,方法,數(shù)據(jù)結(jié)構(gòu)和算法的描述。塊注釋被置于每個(gè)文件的開始處以及每個(gè)方法之前。它們也可以被用于其他地方,比如方法內(nèi)部。在功能和方法內(nèi)部的塊注釋應(yīng)該和它們所描述的代碼具有一樣的縮進(jìn)格式。

塊注釋之首應(yīng)該有一個(gè)空行,用于把塊注釋和代碼分割開來,比如:

/*

* 這里是塊注釋

*/

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

/*-

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

*

* one

*   two

*     three

*/

注意:如果你不使用indent(1),就不必在代碼中使用/*-,或?yàn)樗丝赡軐δ愕拇a運(yùn)行indent(1)作讓步。

單行注釋

短注釋可以顯示在一行內(nèi),并與其后的代碼具有一樣的縮進(jìn)層級。如果一個(gè)注釋不能在一行內(nèi)寫完,就該采用塊注釋。單行注釋之前應(yīng)該有一個(gè)空行。以下是一個(gè)代碼中單行注釋的例子:

if (condition) {

/* 以下代碼運(yùn)行的條件 */

...

}

尾端注釋

極短的注釋可以與它們所要描述的代碼位于同一行,但是應(yīng)該有足夠的空白來分開代碼和注釋。若有多個(gè)短注釋出現(xiàn)于大段代碼中,它們應(yīng)該具有相同的縮進(jìn)。

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

if ($a == 2) {

return TRUE; /* 對單一條件的說明 */

} else {

return isPrime($a); /* 其余的條件 */

}

行末注釋

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

if ($foo > 1) {

// 第二種用法.

...

}

else {

return false; // 說明返回值的原因

}

//if ($bar > 1) {

//

//  // 第三種用法

//  ...

//}

//else {

// return false;

//}

文檔注釋

文檔注釋描述php的類、構(gòu)造器,方法,以及字段(field)。每個(gè)文檔注釋都會被置于注釋定界符/**...*/之中,一個(gè)注釋對應(yīng)一個(gè)類或成員。該注釋應(yīng)位于聲明之前:

/**

* 說明這個(gè)類的一些 ...

*/

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)類、變量或方法的信息,而這些信息又不適合寫在文檔中,則可使用實(shí)現(xiàn)塊注釋(見5.1.1)或緊跟在聲明后面的單行注釋(見5.1.2)。例如,有關(guān)一個(gè)類實(shí)現(xiàn)的細(xì)節(jié),應(yīng)放入緊跟在類聲明后面的實(shí)現(xiàn)塊注釋中,而不是放在文檔注釋中。

文檔注釋不能放在一個(gè)方法或構(gòu)造器的定義塊中,因?yàn)槌绦驎䦟⑽挥谖臋n注釋之后的第一個(gè)聲明與其相關(guān)聯(lián)。

分享:解析PHP動態(tài)網(wǎng)頁技術(shù)中SESSION的應(yīng)用
PHP會話即SESSION是指用戶從進(jìn)入網(wǎng)站到關(guān)閉網(wǎng)站這段時(shí)間內(nèi)活動的一種機(jī)制,它提供了所有網(wǎng)頁都共同使用的公共變量存貯機(jī)制。那么SESSION到底有什么用處呢?網(wǎng)上購物時(shí)大家都用過購物車,你可以隨時(shí)把你選購的商品加入到購物車中,最后再去收銀臺結(jié)帳。在整個(gè)

來源:模板無憂//所屬分類:PHP教程/更新時(shí)間:2009-05-26
相關(guān)PHP教程