前言：

為了提高工作效率,保證開發的有效性和合理性,并最大程度提高程序代碼的可讀性和可重復利用性,提高溝通效率,需要一份代碼編寫規范,本文介紹的規范參考了Zend與PEAR編碼規范,并進行了適當的簡化和調整,盡量堅持簡約易懂.通過代碼規范,讓大家養成良好的代碼編寫習慣,并減少代碼中的bug.

本規范包括PHP開發時程序編碼中的命令規范、代碼縮進規則、控制結構、函數調用、函數定義、注釋、包括代碼、PHP標記、常量命名等方面的規則.

本規范不強制指定和保舉某種格式,并就實際開發中個人習慣做了一些調整,僅供大家參考.

1. 文件格式

• 1.1 文件標記

  所有的PHP文件,其代碼標記均使用完整PHP標簽,不建議使用短標簽,對于只含有PHP代碼的文件,將在文件結尾忽略“?>”,這是因為防止多余空格或者其他字符影響到代碼.

• 1.2 文件和目錄命名

  程序文件和目錄名均采用有意義的英文命名,不使用拼音或者無意義的字母,只允許出現字母、數字、下劃線和中劃線字符,同時必須以".php"結尾,多個詞間使用駝峰法命名.

• 1.3 文件目錄結構

  在開發規范、獨立的PHP項目時,使用規范的文件目錄結構,有助于提高項目邏輯結構合理性,對于拓展和合作以及團隊開發均有好處.

通常一個完整獨立的PHP項目的文件目錄結構

2. 命名規范

• 2.1 變量命名

PHP中的變量用一個美元符號后面跟變量名表示.變量名區分大小寫.一個有效變量名由字母或者下劃線開頭,后面跟任意數量的字母、數字、下劃線.正常的正則表達式為：

[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*

不應該在變量中使用中文等ASCII字符.

1)程序整體

程序整體以駝峰法命名,以小寫字母開始,同時命名要有意義

2)PHP全局變量鍵值

PHP全局變量鍵值兩邊都有“_”,中間使用駝峰法命名,如 $_GLOBAL['_beginTime_']

3)普通變量

普通變量整體采用駝峰法,建議在變量前加表示類型的前綴,不確定類型的以大寫字母開頭,函數參數不確定的類型以大寫字母開頭,其他地方的變量以小寫字母開頭,對于一些常見變量,按著約定命名,并避免使用常用關鍵字或者存在模糊意義的單詞,變量應以名詞為主,保舉：

字符串：$strName

數組：$arrName

對象：$objName

布爾值：$bool

4)函數名

函數名既要有意義,也要盡量縮寫,建議采用動詞或者動詞加形容詞的命名方式,如showMsg.

5)類中的屬性

類中的屬性變量遵循普通變量的命名規則

• 2.2 類及接口命名

在面向對象的代碼中,其命名方式有一些特殊,類的命名遵循以下規則：

以大寫字母開頭：多個單詞組成的變量名,單詞之間不用間隔,各個單詞首字母大寫；

類名與類文件堅持一致；

程序中所有類名唯一；

抽象類應以Abstract開頭;

接口命名遵循以下規則：

采取和類相同的命名規則,但是在其命名前加i字符,表示接口；

盡量堅持和實現它的類名一致；

• 2.3 數據庫命名

  在數據庫相關的命名中,一律不出現大寫,詳細的命名規則如下：

  1)數據庫命名遵循以下規范：

  表名均使用小寫；

  表名字使用統一的前綴,且前綴不能為空；

  對于多個單詞組成的表名,使用“_”間隔.

  2)表字段命名遵循以下規范：

全部使用小寫字母命名；

多個單詞使用下劃線

• 2.4 習慣與約定

  1)縮寫

  依照習慣,同時為了減小變量的長度,在不影響可讀的前提下,習慣對變量進行縮寫,常見于一些函數的參數,如：

  image -> img

  string -> str

  database -> db

  array -> arr

  count -> cnt

  message -> msg

  2)魔術數字

  魔術數字是指直接在程序代碼里的具體數值,此類變量盡量定義為常量.

3.注釋規范

每個程序必須提供必要的注釋,包含文件注釋,代碼塊注釋,函數注釋等.

• 3.1 程序注釋

  程序注釋原則如下：

  寫在被注釋代碼前面,而不是很后面,對于單行語句,按著習慣可以把注釋放在語句末尾.對于大段注釋,使用“/**/”格式,通常在文件和函數注釋中使用,而代碼內部統一使用“//”注釋,因為其寫起來簡單.注釋不宜太多.

• 3.2 文件注釋

  文件注釋通常放在整個PHP文件頭部,其內容包含文件版權,作者,日期,版本號等重要信息.PHP中,可以參照phpdocument規范,便于利用程序自動生成文檔.

  文件注釋遵循以下規則：

  本程序的描述；

  作者；

  項目名稱；

  文件名稱；

  日期；

  版本；

  使用說明等；

文件注釋說明

• 3.3 辦法和函數注釋

  辦法和函數的注釋寫在前面,通常需要標明的信息包括函數說明、參數類型和返回值的類型.

4.代碼風格

• 4.1 縮進和空格

  在書寫代碼的時候,必須注意代碼的縮進規則：

  使用4個空格作為縮進,而不是tab縮進；

  變量賦值時,等號左右留下空格；

為了最大程度減輕工作量,堅持代碼美觀,建議使用大型IDE管理代碼.

• 4.2 語句斷行

  代碼書寫中應遵循以下原則：

  盡量保證程序語句一行就是一句；

盡量不要使一行代碼太長,一般控制在100個字符以內；

如果一行代碼太長,請使用 “.=” 的方式斷行書寫；

執行數據庫sql語句操作時,盡量不要在函數內寫sql語句,而是先用變量定義sql語句,然后在執行操作的函數中調用定義的變量；

小結：

在開頭就提到編碼規范的目的是提高工作效率,保證開發的有效性和合理性,并最大程度的提高程序代碼的可讀性和可重復利用性,減少返工,提高溝通效率.好的代碼風格,見代碼如見人.

PHP是一門腳本語言,本身就是一門不嚴謹的語言,所以規范就顯得更重要了.

強烈建議使用大型IDE進行代碼開發和管理,并使用合適的版本控制軟件,保舉PhpStorm 和 Git.