JoshChen_php新手进阶高手不可或缺的规范介绍

PHP规范
1. 为什么要编码规范
•编码规范(code conventions)对于程序员而言尤为重要，有以下几个原因：
1.在一个软件的生命周期中，80%的花费用于维护。

2.几乎没有任何一个软件在其整个生命周期中均由最初的开发人员来维护。

3.编码规范可以改善软件的可读性，可以让程序员尽快而彻底地理解新的代码。

4.如果将源码作为产品发布，就需要确认它是否被很好地打包并且清晰无误，和其他已构建的任何产品一样。

2. 概要
•用四个空格代替tab缩进。
•去掉PHP文件底部的“?>”。
•每行程序一般少于80字符，超出部分，分成多行书写。
•每行只写一条语句，不允许把多个短语句写在一行中。
•应为文件和函数添加注释。
•应及时删除废除的注释代码。
•变量、函数的命名应规范。

3. 编辑器设定
3.1. 缩进
所有的缩进使用空格取代Tab制表符。PHP文件采用4个空格的缩进，HTML文件以及HTML文件中嵌入的Javascript代码采用2个空格的缩进；单独的 Javascript以及CSS文件采用4个空格的缩进。

3.2. 字符编码
所有PHP、HTML文件均保存为No Bom UTF-8的字符编码。

4. 代码布局
4.1. 文件底部
去掉文件底部 “?>”。

4.2. 相对独立的程序块之间、变量说明之后必须加空行
示例：如下例子不符合规范
代码如下:
if (!$valid_ni()){
    ... // program code
}
$repssn_ind = $ssn_data['index']->repssn_index;
$repssn_ni  = $ssn_data['index']->ni;
应如下书写:

if (!valid_ni(){
    ... // program code
}

$repssn_ind = $ssn_data['index]->repssn_index;
$repssn_ni  = $ssn_data[index]->ni;

4.3. 较长的语句要分成多行书写
一行程序需小于80字符

较长的语句要分成多行书写，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进，使排版整齐，语句可读。

循环、判断等语句中若有较长的表达式或语句，则要进行适应的划分，长表达式要在低优先级操作符处划分新行，操作符放在新行之首示例：
代码如下:
$perm_count_msg->len = NO7_TO_STAT_PERM_COUNT_LEN
                          + STAT_SIZE_PER_FRAM * strlen( $len );

$act_task_table[$frame_id * STAT_TASK_CHECK_NUMBER + $index]->occupied
              = $stat_poi[index]->occupied;

$act_task_table[taskno]->duration_true_or_false
              = sys_get_sccp_statistic_state( $stat_item );