php編程的規(guī)范有哪些

<&#63;
/*
 +----------------------------------------------------------------------
 + Title    : 標(biāo)題
 + Author    : 作者
 + Version   : 版本號(hào)
 + Initial-Time : 這個(gè)文件初始創(chuàng)建的時(shí)間
 + Last-time  : 這個(gè)文件最后修改的時(shí)間 + 修改人的名稱
 + Desc     : 這個(gè)文件的簡(jiǎn)單描述
 +----------------------------------------------------------------------
*/

<&#63;
/**
 * 函數(shù)體簡(jiǎn)單的描述
 * @author_start : 作者
 * @author_end  : 修改時(shí)間 + 修改者
 * @param string : $id    描述
 * @param array : $array 描述
 * @param array : $num  描述
 * @return : 返回值說明
*/
function Test($id, $array = array(), $num = 1){
}

<&#63;
$str = 1;
$info = '123';
$version = '123123';
$name = 'test';
$i  = 'haha';
 
# 一般在最外部的if 或流程控制語(yǔ)句都應(yīng)該上下留空一行
if ($info) {
 
}
 
# 一般在最外部的for或者 foreach都應(yīng)該上下留空一行
for ($i=0 ,$i<6 ,$i++){
 
}

<&#63;
# 一般在if語(yǔ)句與其分支的流程控制語(yǔ)句當(dāng)中,存在這exit或者return的情況下,都應(yīng)該省略其else的部分操作
# 錯(cuò)誤
if () {
  return false;
} else {
  return true;
}
# 正確
if () {
  return false;
}
return true;

<&#63;
# 正確
$title = '標(biāo)題';
$name = '名稱';
$pwd  = '密碼';
# 錯(cuò)誤
$biaoti = '標(biāo)題';
$ming  = '名稱';
$mima  = '密碼';

<&#63;
/**
 * 實(shí)際開發(fā)中，命名方式一般有三種情況
 * 注意：不管是類名，變量，方法名，在實(shí)際開發(fā)中，最多只能是不超過3個(gè)單詞的組合
 * 大駝峰 ：每個(gè)單詞首字母大寫
 * 小駝峰 ：中間單詞首字母大寫 
 * 蛇形  ：每個(gè)單詞小寫，單詞與單詞之間使用 _ 符合鏈接
 */
 
# 大駝峰，常用于類名定義
class Car{}
class BlueCar{}
 
# 小駝峰，常用于方法名定義
class Car{
 public function getColor(){}
}
 
# 蛇形，常用于變量名定義
$res_id  = 1;
$res_name = 2;

<&#63;
1、當(dāng)需要對(duì)某段代碼，做大量描述時(shí)，使用以下注釋風(fēng)格
/**
 * 我是說明
 * ① 流程一
 * ② 流程二
 * ③ 流程三
 */
 
2、當(dāng)需要對(duì)一行代碼，做小量描述時(shí)，使用以下注釋風(fēng)格
# 這是XXXX給ZZZZ的變量，叫CCCC
$name = '';
 
3、當(dāng)需要對(duì)一行代碼，做簡(jiǎn)介描述時(shí)，使用以下注釋風(fēng)格
$name    = ''; // X表的字段
$index_head = ''; // 首頁(yè)請(qǐng)求頭