PHP教程:PHP編碼書寫規(guī)范(6)_PHP教程
推薦:PHP中addcslashes函數(shù)與stripcslashes的用法今天在寫一個網(wǎng)站的英文版時,寫完后填加英文資料,我隨便填寫時一點(diǎn)問題沒有,但每當(dāng)填加指定的內(nèi)容時卻填加不上,也不報錯,我查看了數(shù)據(jù)庫,發(fā)現(xiàn)這個字段用的是“TEXT”數(shù)據(jù)數(shù)型,
8 命名規(guī)范
8.1 命名空間
一個唯一命名空間的前綴總是全部小寫的ASCII字母并且是一個頂級域名,通常是com,edu,gov,mil,net,org,或1981年ISO 3166標(biāo)準(zhǔn)所指定的標(biāo)識國家的英文雙字符代碼。命名空間的后續(xù)部分根據(jù)不同機(jī)構(gòu)各自內(nèi)部的命名規(guī)范而不盡相同。這類命名規(guī)范可能以特定目錄名的組成來區(qū)分部門(department),項目(project),機(jī)器(machine),或注冊名(login names),也可以按功能模塊來分類。
8.2 類
類名是個一名詞,采用大小寫混合的方式,每個單詞的首字母大寫。盡量使你的類名簡潔而富于描述。使用完整單詞,避免縮寫詞(除非該縮寫詞被更廣泛使用,像URL,HTML)
class Raster; class ImageSprite |
在為類(class)命名前首先要知道類的功能。如果通過類名的提供的線索,不能準(zhǔn)確反映類的功能,那么,命名就是失敗的。
超過三個詞組成的混合名是容易造成系統(tǒng)各個實體間的混淆,嘗試使用(CRC Session card)看看該命名所對應(yīng)的實體是否有著那么多的功用。
對于派生類的命名應(yīng)該避免帶其父類名的誘惑,一個類的名字只與它自身有關(guān),和它的父類無關(guān)。
有時后綴名是有用的,例如:如果你的系統(tǒng)使用了代理(agent),那么就把某個部件命名為“下載代理”(downloadAgent)用以真正的傳送信息。
8.2.1 類屬性的命名
屬性命名應(yīng)該以字符‘m’為前綴。
前綴‘m’后采用于類命名一致的規(guī)則。
‘m’總是在名字的開頭起修飾作用,就像以‘r’開頭表示引用一樣。
理由
前綴'm'防止類屬性和方法名發(fā)生任何沖突。你的方法名和屬性名經(jīng)常會很類似,特別是存取元素。
例如
class NameOneTwo { int $mVarAbc; int $mErrorNumber; String $mrName; } |
8.3 函數(shù)
方法名是一個動詞,采用大小寫混合的方式,第一個單詞的首字母小寫,其后單詞的首字母大寫。
function run(); function runFast(); function getBackground(); |
通常每個方法都是執(zhí)行一個動作的,所以對它的命名應(yīng)該清楚的說明它是做什么的:用checkForErrors()代替errorCheck(),用dumpDataToFile()代替dataFile()。這么做也可以使功能和數(shù)據(jù)成為更可區(qū)分的物體。
有時后綴名是有用的:
Max - 含義為某實體所能賦予的最大值。
Cnt - 一個運(yùn)行中的計數(shù)變量的當(dāng)前值。
Key - 鍵值。
例如:retryMax 表示最多重試次數(shù),retryCnt 表示當(dāng)前重試次數(shù)。
有時前綴名是有用的:
is - 含義為問一個關(guān)于某樣事物的問題。無論何時,當(dāng)人們看到Is就會知道這是一個問題。
get - 含義為取得一個數(shù)值。
set - 含義為設(shè)定一個數(shù)值
例如:isHitRetryLimit
8.4 變量
除了變量名外,所有實例,包括類,類常量,均采用大小寫混合的方式,第一個單詞的首字母小寫,其后單詞的首字母大寫。變量名不應(yīng)以下劃線或美元符號開頭,盡管這在語法上是允許的。
變量名應(yīng)簡短且富于描述。變量名的選用應(yīng)該易于記憶,即,能夠指出其用途。盡量避免單個字符的變量名,除非是一次性的臨時變量。臨時變量通常被取名為i,j,k,m和n,它們一般用于整型;c,d,e,它們一般用于字符型。
| char $c; int $i; float $myWidth; |
8.5 實例變量
大小寫規(guī)則和變量名相似,除了前面需要一個下劃線
int $_employeeId; String $_name; Customer $_customer; |
8.6 常量
類常量和ANSI常量的聲明,應(yīng)該全部大寫,單詞間用下劃線隔開。(盡量避免ANSI常量,容易引起錯誤)
static final int $MIN_WIDTH = 4; static final int $MAX_WIDTH = 999; static final int $GET_THE_CPU = 1; |
分享:PHP.MVC的模板標(biāo)簽系統(tǒng)PHP.MVC的模板標(biāo)簽系統(tǒng)(PhpMVC_Tags)現(xiàn)在提供了3種類型的標(biāo)簽:包含指令,聲明和表達(dá)式. 包含指令能讓我們將內(nèi)容分隔為許多模塊,比如:頁眉,頁腳或者內(nèi)容.包含的頁面可以是HTML,或者其他標(biāo)簽?zāi)0屙?/p>
- PHPNOW安裝Memcached擴(kuò)展方法詳解
- php記錄頁面代碼執(zhí)行時間
- PHP中獎概率的抽獎算法程序代碼
- apache設(shè)置靜態(tài)文件緩存方法介紹
- php對圖像的各種處理函數(shù)代碼小結(jié)
- PHP 關(guān)于訪問控制的和運(yùn)算符優(yōu)先級介紹
- 關(guān)于PHP語言構(gòu)造器介紹
- php/js獲取客戶端mac地址的實現(xiàn)代碼
- php5.5新數(shù)組函數(shù)array_column使用
- PHP preg_match的匹配多國語言的技巧
- php 中序列化和json使用介紹
- php采集文章中的圖片獲取替換到本地
PHP教程Rss訂閱編程教程搜索
PHP教程推薦
- 用PHP操縱Oracle的LOB類型的數(shù)據(jù)
- 創(chuàng)建論壇專業(yè)知識庫 HDWiki(For Discuz!)V1.0正式版發(fā)布
- php gzip壓縮輸出的實現(xiàn)方法
- Windows IIS環(huán)境下安裝和配置PHP開發(fā)環(huán)境
- php調(diào)用MySQL存儲過程的方法集合
- PHP 關(guān)于訪問控制的和運(yùn)算符優(yōu)先級介紹
- 解析PHP跳出循環(huán)的方法以及continue、break、exit的區(qū)別介紹
- PHP實現(xiàn)靜態(tài)發(fā)布的方法淺談
- 解析PHP程序編譯中常見錯誤信息
- 一個簡單的PHP框架實現(xiàn)方法
- 相關(guān)鏈接:
- 教程說明:
PHP教程-PHP教程:PHP編碼書寫規(guī)范(6)
。