一、文件格式
1. 對於只含有 php 代碼的文件,我們將在文件結尾處忽略掉 "?>" 。這是為了防止多余的空格或者其它字符影響到代碼。
例如:
$foo = 'foo';
2. 縮進應該能夠反映出代碼的邏輯結果,盡量使用四個空格,禁止使用制表符TAB,因為這樣能夠保證有跨客戶端編程器軟件的靈活性。
例如:
if (1 == $x) {
$indented_code = 1;
if (1 == $new_line) {
$more_indented_code = 1;
}
}
3. 變量賦值必須保持相等間距和排列。
例如:
$variable = 'demo';
$var = 'demo2';
4. 每行代碼長度應控制在80個字符以內,最長不超過120個字符。因為 linux 讀入文件一般以80列為單位,就是說如果一行代碼超過80個字符,那麼系統將為此付出額外操作指令。這個雖然看起來是小問題,但是對於追求完美的程序員來說也是值得注意並遵守的規范。
5. 每行結尾不允許有多余的空格。
二、命名約定
1. 類文件都是以“.class.php“為後綴,且類文件名只允許字母,使用駝峰法命名,並且首字母大寫,例如:DbMysql.class.php 。
2. 配置和函數等其他類庫文件之外的文件一般是分別以“.inc.php“和”.php“為後綴,且文件名命名使用小寫字母和下劃線的方式,多個單詞之間以下 劃線分隔,例如config.inc.php , common.php,install_function.php 。
3. 確保文件的命名和調用大小寫一致,是由於在類Unix系統上面,對大小寫是敏感的。
4. 類名和文件名一致(包括上面說的大小寫一致),且類名只允許字母,例如 UserAction類的文件命名是UserAction.class.php, InfoModel類的文件名是InfoModel.class.php 。
5. 控制器類以Action為後綴,例如 UserAction、InfoAction ,模型類以Model為後綴,例如UserModel、InfoModel ,其他類也分別以相應分類為後綴,例如Service 、Widget。
6. 方法名只允許由字母組成,下劃線是不允許的,首字母要小寫,其後每個單詞首字母要大寫,即所謂的 “駝峰法命名” 規則,且越詳細越好,應該能夠描述清楚該方法的功能,例如switchModel、findPage。
7. 屬性的命名只允許由字母組成,下劃線是不允許的,首字母要小寫,其後每個單詞首字母要大寫,即所謂的 “駝峰法命名” 規則,例如tablePrefix、tableName 。
8. 對於對象成員的訪問,我們必須始終使用 “get” 和 “set” 方法。例如:
class Foo
{
protected $_testObj;
public function getTestObj()
{
// ...
}
}
11. 被聲明為 private的類成員屬性必須由雙下劃線 "__" 作為開頭;被聲明為 protected 的類成員屬性必須由下劃線 "_" 作為開頭;而聲明為 public 的成員屬性則在任何時候都不允許含有下劃線。
12. 函數的命名使用小寫字母和下劃線的方式,且越詳細越好,應該能夠描述清楚該函數的功能,例如 get_client_ip 。
13. 當方法或函數參數不一定需要被賦值的時候,用 "null" 來代替 "false" 作為函數參數的默認值,除非該參數是 boolean 值。
14. 變量只允許由小寫字母和下劃線組成,且建議用描述性的變量的命名,越詳細越好,以至於像 $i 或 $n 等等都是不鼓勵使用的。
15. 類中的常量 constant 和全局范圍內常量define,只能由大寫字母和下劃線組成,各個單詞之間以下劃線分割。
16. boolean 值和 null 值都采用小寫。
三、編碼風格
1. php 代碼必須以完整的形式來定界(),即不要使用php 短標簽(),且保證在關閉標簽後不要有任何空格。
2. 當一個字符串是純文本組成的時候(即不含有變量),則必須總是以單引號(')作為定界符。例如:
$a = 'Example String';
3. 變量替換中的變量只允許用 $+變量名 的形式。例如:
$greeting = "Hello $name, welcome back!"; // 允許
$greeting = "Hello {$name}, welcome back!"; // 允許
$greeting = "Hello ${name}, welcome back!"; // 不允許
當用點號 "." 連接各字符串的時候,字符串與點號間必須用一個空格隔開,且允許把它分割成多行以增強可讀性。在這種情況下,點號 "." 必須與等於號 "=" 對齊。例如:
$sql = "SELECT `id`, `name` " . " FROM `people` "
. "WHERE `name` = 'Susan' "
. "ORDER BY `name` ASC ";
當用 array 類型符號來構造數組的時候,必須在每個逗號之後加上一個空格來增強可讀性。例如:$sampleArray = array(1, 2, 3, 'Think', 'SNS');
4. 當使用 array 類型符聲明關聯數組的時候,我們鼓勵把它分成多個行,只是我們必須同時保證每行的鍵與值的對齊,以保持美觀。例如:
$sampleArray = array(
'firstKey' => 'firstValue',
'secondKey' => 'secondValue'
);
5. 大括號的開始必須在類名的下一行頂格。例如:
class Think
{
// ...
}
6. 類中的所有代碼都必須用四個空格來進行縮進。
7. 每個 php 文件只允許聲明一個類。在類文件裡面寫其它代碼是允許的,但並不鼓勵這樣做。假如真要附加代碼的話,必須用空行來分隔。
8. 任何類變量的聲明都必須放在類頂部,先於任何函數的聲明。
9. 不允許用 var 符號來聲明變量,類成員變量必須以 private,protected 和 public 來聲明。其次,把類成員聲明為 public 而直接引用雖然是允許的,但通常更好的方法是使用 get 和 set 方法來訪問類成員。
10. 方法必須總是用 private,protected 或者 public 來聲明其作用域。
11. 靜態 static 方法應該聲明其作用域,且不應該再被聲明為 private 私有,而應該為 protected 或者public ,如果只是不想被子類繼承,則應該用 final 聲明它們。
12. 函數或方法的初始大括號應該在函數聲明的下一行頂格。例如:
function get_client_ip()
{
// …
}
13. 在函數或方法名與參數括號之間不允許出現多余的空格。例如:
function get_client_ip()
{
// …
}
14. 引用只允許定義在函數參數中,實時傳遞引用是禁止的。例如:
// 引用定義在函數參數-允許的
function defineRefInMethod(&$a)
{
$a = 'a';
}
defineRefInMethod($b);
echo $b; // 'a'
// 實時傳遞引用-禁止的
function callTimePassRef($a)
{
$a = 'a';
}
callTimePassRef(&$c);
echo $c; // 'a'
15. 函數或方法返回值不可以用括號包住,不然會降低可讀性,而且假如以後函數修改為返回引用的話,這將會拋出一個異常。
16. 鼓勵盡量使用類型提示,特別是在模塊設計中。例如:
class Foo
{
public function foo(SomeInterface $object)