標籤:符號 ati set 第一個字元 space 技術分享 空白 名稱 func
在寫代碼的時候,一個好的編碼規範,對我們來說能夠起到很多意向不到的效果。比如:
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 則必須寫在其後;
方法及函數的聲明和調用時,方法名或函數名與參數左括弧之間一定不能有空格,參數左括弧後與右括弧前也一定不能有空格,參數列表中每個逗號後面必須要有一個空格,而逗號前面一定不能有空格。
PHP命名規範
控制結構
控制結構轉折(else、else if、catch 以及 do ... while 結構中的 while)關鍵字與上一結構體的結束花括弧(})必須寫在同一行中,兩者之間一定有一個空格;
控制結構的開始花括弧({)必須寫在聲明的同一行,而結束花括弧(})必須寫在主體後自成一行;
控制結構的關鍵字後必須要有一個空格,右括弧 ) 與開始花括弧 { 間也一定有一個空格;
條件括弧左括弧後與右括弧前一定不能有空格,兩個子句句之間(分號之後)一定有一個空格;
每個結構體的主體都必須被包含在成對的花括弧之中。
閉包
開始花括弧必須寫在聲明的同一行,結束花括弧必須緊跟主體結束的下一行;
閉包聲明時,關鍵詞 function 後以及關鍵詞 use 的前後都必須要有一個空格;
參數列表和變數列表的左括弧後以及右括弧前,必須不能有空格;
參數和變數列表中,逗號前必須不能有空格,而逗號後必須要有空格。
變數與關鍵字
PHP所有 關鍵字 必須全部小寫,常量 true 、false 和 null 也必須全部小寫;
變數賦值和比較(包括控制結構條件陳述式和數組中)的操作符(=、>、< 以及 =>)兩端必須各有一個空格,但自增(++)自減(--)操作變數與符號之間一定不能有空格;
變數聲明應該使用底線分隔的小寫字母,不應該使用非通用的單詞簡寫,不應該出現英文以外的拼字或簡寫;
array、emtpy、isset、unset 等關鍵字括弧內的變數兩端必須不能有多餘的空格;
數組聲明和使用都應該使用[] 代替 array();
需要換行陣列變數的聲明,數組開始符號([ 或 array()應該和操作符在同一行,數組的第一個元素應該在新的一行開始,且與上一行之間必須保持一個縮排,數組的結束符號([ 或 ])必須新起一行,且應該與變數的第一個字元對齊。
勿忘初心,方得始終
php命名規則幾點內容