php命名規則幾點內容
在寫代碼的時候,一個好的編碼規範,對我們來說能夠起到很多意向不到的效果。比如:
1、提高我們的編碼效率。整齊劃一的代碼方便我們進行復制粘貼哦!
2、提高代碼的可讀性。
3、顯示我們專業。別人看到了我們的代碼,發現整個代碼的書寫流程都整齊劃一,瞬間逼格就上去了!
4、方便團隊協同工作。大家使用同一的規範,這樣就消除了五花八分的書寫方式,同一協調!
那麽一起來看下都有那些規範呢?
文件與行
-
PHP 代碼文件必須以 <?php起;
-
代碼必須使用4個空格符而不是 tab 鍵進行縮進;
-
PHP 代碼文件必須以 不帶 BOM 的 UTF-8 編碼;
-
純 PHP 代碼文件必須省略最後的 ?> 結束標簽;
-
所有 PHP 文件必須以一個空白行作為結束;
-
所有 PHP 文件必須使用Unix LF (linefeed)作為行的結束符;
-
視圖文件中的 PHP 代碼(模板代碼除外)必須使用 <?php ?> 長標簽 或 <?= ?> 短輸出標簽;一定不可使用其它自定義標簽。
-
非空行後一定不能有多余的空格符;
-
每行的字符數應該保持在80個之內, 不應該多於120個;
-
每行一定不能存在多於一條語句。
類,方法,屬性
-
命名空間以及類必須符合 PSR 的自動加載規範:PSR-4;
-
PHP代碼中應該只定義類、函數、常量等聲明或只定義其他會產生 從屬效應 的操作(如:生成文件輸出、引入文件以及修改 ini 配置文件等),二者只能選其一;
-
類的命名必須遵循 StudlyCaps 大寫開頭的駝峰命名規範;
-
類中的常量所有字母都必須大寫,單詞間用下劃線分隔;
-
方法名稱必須符合 camelCase 式的小寫開頭駝峰命名規範;
-
use聲明必須位於namespace聲明之後, 每個 namespace 命名空間聲明語句塊和 use 聲明語句塊後面,必須插入一個空白行;
-
類與方法的開始花括號({)必須寫在函數聲明後自成一行,結束花括號(})也必須寫在函數主體後自成一行;
-
關鍵詞 extends 和 implements必須寫在類名稱的同一行;
-
每條語句一定不能定義超過一個屬性,一定不可使用關鍵字 var 聲明一個屬性;
-
類的屬性和方法必須添加訪問修飾符(private、protected 以及 public),不要使用下劃線_作為前綴來區分屬性是 protected 或 private;
-
需要添加 abstract 或 final 聲明時, 必須寫在訪問修飾符前,而 static 則必須寫在其後;
-
方法及函數的聲明和調用時,方法名或函數名與參數左括號之間一定不能有空格,參數左括號後與右括號前也一定不能有空格,參數列表中每個逗號後面必須要有一個空格,而逗號前面一定不能有空格。
控制結構
-
控制結構轉折(else、else if、catch 以及 do ... while 結構中的 while)關鍵字與上一結構體的結束花括號(})必須寫在同一行中,兩者之間一定有一個空格;
-
控制結構的開始花括號({)必須寫在聲明的同一行,而結束花括號(})必須寫在主體後自成一行;
-
控制結構的關鍵字後必須要有一個空格,右括號 ) 與開始花括號 { 間也一定有一個空格;
-
條件括號左括號後與右括號前一定不能有空格,兩個子句句之間(分號之後)一定有一個空格;
-
每個結構體的主體都必須被包含在成對的花括號之中。
閉包
-
開始花括號必須寫在聲明的同一行,結束花括號必須緊跟主體結束的下一行;
-
閉包聲明時,關鍵詞 function 後以及關鍵詞 use 的前後都必須要有一個空格;
-
參數列表和變量列表的左括號後以及右括號前,必須不能有空格;
-
參數和變量列表中,逗號前必須不能有空格,而逗號後必須要有空格。
變量與關鍵字
-
PHP所有 關鍵字 必須全部小寫,常量 true 、false 和 null 也必須全部小寫;
-
變量賦值和比較(包括控制結構條件語句和數組中)的操作符(=、>、< 以及 =>)兩端必須各有一個空格,但自增(++)自減(--)操作變量與符號之間一定不能有空格;
-
變量聲明應該使用下劃線分隔的小寫字母,不應該使用非通用的單詞簡寫,不應該出現英文以外的拼寫或簡寫;
-
array、emtpy、isset、unset 等關鍵字括號內的變量兩端必須不能有多余的空格;
-
數組聲明和使用都應該使用[] 代替 array();
-
需要換行數組變量的聲明,數組開始符號([ 或 array()應該和操作符在同一行,數組的第一個元素應該在新的一行開始,且與上一行之間必須保持一個縮進,數組的結束符號([ 或 ])必須新起一行,且應該與變量的第一個字符對齊。
php命名規則幾點內容