- 相關(guān)推薦
PHP編程風(fēng)格規(guī)范分享
本規(guī)范由 EasyChen 借鑒 SINA網(wǎng)絡(luò)應(yīng)用開發(fā)部《C++開發(fā)規(guī)范》和互動(dòng)技術(shù)部《PHP4開發(fā)規(guī)范》,以及phpDocument規(guī)范 整理出的開發(fā)規(guī)范。我覺得非常不錯(cuò), 適合PHP的開發(fā),給大家參考,養(yǎng)成一個(gè)良好的編程風(fēng)格是非常有必要的。
說(shuō)明:本規(guī)范由 EasyChen 借鑒 SINA網(wǎng)絡(luò)應(yīng)用開發(fā)部《C++開發(fā)規(guī)范》和互動(dòng)技術(shù)部《PHP4開發(fā)規(guī)范》,以及phpDocument規(guī)范 整理出的開發(fā)規(guī)范。我覺得非常不錯(cuò), 適合PHP的開發(fā),給大家參考,養(yǎng)成一個(gè)良好的編程風(fēng)格是非常有必要的。
第1章 命名規(guī)范
1.1變量
1.1.1全局變量
全局變量使用$g_開頭,如$g_data_list。
1.1.2 一般變量
一般的變量使用小寫字母命名,單詞之間使用下劃線分隔。
變量名字應(yīng)該使用名詞或者形容詞+名詞的方式。如$value,$new_value。
1.1.3 臨時(shí)變量
不要將在循環(huán)中頻繁使用的臨時(shí)變量如$i、$j等用于其它用途。
1.2 函數(shù)
函數(shù)采用小寫字母命名,單詞之間使用下劃線分隔。
函數(shù)的命名建議使用動(dòng)詞+名詞的方式,如get_user_img。
完成一組功能的函數(shù)放到一個(gè)文件中,存放函數(shù)的文件采用function_name.func.php命名。
1.3 類
類使用英文的大小寫來(lái)分隔單詞,包括首個(gè)單詞,所有單詞的首字母大寫,如PageManager;
在類中,方法放到屬性定義前邊、公用方法放到專用方法前邊;
一般情況下,一個(gè)類對(duì)應(yīng)到一個(gè)文件;
當(dāng)一些類關(guān)系緊密時(shí),可以存放在一個(gè)文件中;
存放類的文件采用ClassName.class.php方式命名。
1.4 方法
方法使用英文的大小寫來(lái)分隔單詞,除首個(gè)單詞外,其他單詞的首字母大寫,如getCurrentPage();
不要采用不常用的縮寫,如where2go();
使用常用的縮寫時(shí),只大寫首字母,如getHtml()。
第2章 版式規(guī)則
2.1 語(yǔ)義分隔
各個(gè)函數(shù)、方法之間應(yīng)該采用空行間隔;
同一個(gè)函數(shù)中聯(lián)系緊密的語(yǔ)句之間可以不換行,其他情況需要換行。
2.2 空格規(guī)則
2.2.1 邏輯運(yùn)算符前后必須加空格
正確
復(fù)制代碼 代碼如下:
$a == $b;
錯(cuò)誤
復(fù)制代碼 代碼如下:
$a==$b;
$a ==$b;
正確
復(fù)制代碼 代碼如下:
$a++; $a--;
錯(cuò)誤
復(fù)制代碼 代碼如下:
$a ++; $a --;
備注 加一減一運(yùn)算符不能加空格。
2.2.2 多個(gè)參數(shù)分隔時(shí)必須加空格
正確
復(fù)制代碼 代碼如下:
$g_pro , $g_user , g_show;
get_db_info($host, $user, $passwd);
錯(cuò)誤
復(fù)制代碼 代碼如下:
$g_pro,$g_user,$g_show;
get_db_info($host,$user,$passwd);
2.2.3 語(yǔ)法關(guān)鍵字后必須加空格
例如:If, for , while, switch …..
正確
復(fù)制代碼 代碼如下:
for ($i = 0; $i < 10; $i++)
錯(cuò)誤
復(fù)制代碼 代碼如下:
for($i = 0; $i < 10; $i++ )
2.3 字符串和變量連接規(guī)則
字符串與變量連接使用'.'號(hào)時(shí),必須在'.'前后加空格,使用"號(hào)時(shí),必須在變量前后加"{}"。
正確
復(fù)制代碼 代碼如下:
$my_name = 'file_' . $var1;
$my_name = "file_{$var1}";
錯(cuò)誤
復(fù)制代碼 代碼如下:
$my_name = "file_'.$var1;
$my_name = "file_$var1";
2.4 圓括號(hào)規(guī)則
函數(shù)名后括號(hào)不需要加空格、語(yǔ)法關(guān)鍵字后的括號(hào)必須加空格。
正確
復(fù)制代碼 代碼如下:
for ($i = 0; $i < 10; $i++)
strlen($my_name);
錯(cuò)誤
復(fù)制代碼 代碼如下:
for($i = 0; $i < 10; $i++ )
strlen ($my_name);
2.5 花括號(hào)規(guī)則
花括號(hào)必須為上下對(duì)應(yīng)。
正確
復(fù)制代碼 代碼如下:
if ($a)
{
$b = $a;
}
錯(cuò)誤
復(fù)制代碼 代碼如下:
if ($a){
$b = $a;
}
2.6 數(shù)組定義規(guī)則
數(shù)組定義和使用時(shí)中key值前后必須加單引號(hào)。
PHP 代碼:
正確
復(fù)制代碼 代碼如下:
array( 'name' => '', 'gender' => '' );
$user_info['name'];
錯(cuò)誤
復(fù)制代碼 代碼如下:
array( name => '', gender => '' );
$user_info[name];
2.7 SQL規(guī)則
在PHP中嵌入的SQL語(yǔ)句關(guān)鍵字全部采用大寫;
表名和字段名要用反引號(hào)(`)引起來(lái)以防止因?yàn)樽侄蚊邪崭穸霈F(xiàn)錯(cuò)誤;
數(shù)據(jù)值兩邊用單引號(hào)''包括,并且應(yīng)確保數(shù)據(jù)值中的單引號(hào)已經(jīng)轉(zhuǎn)義以防止SQL注入。
正確
復(fù)制代碼 代碼如下:
$sql = "SELECT `user`.`name` FROM `user` WHERE `id` = '$id' LIMIT 1";
錯(cuò)誤
復(fù)制代碼 代碼如下:
$sql = "select name.user from name where id = $id ";
第3章 注釋規(guī)則
【PHP編程風(fēng)格規(guī)范分享】相關(guān)文章:
PHP符合PSR編程規(guī)范的實(shí)例07-31
PHP編程與應(yīng)用06-06
php語(yǔ)言編程07-06
PHP Socket編程過(guò)程07-19
學(xué)習(xí)PHP編程語(yǔ)言的優(yōu)勢(shì)08-09
如何自學(xué)PHP編程語(yǔ)言07-28
PHP編程語(yǔ)言搶手的原因08-11
php編程語(yǔ)言入門知識(shí)05-22