当前位置:博客首页>>PHP >> 阅读正文

PHP编码规范文档

作者: _Approaching 分类: PHP 发布于: 2012-03-16 23:10 浏览:4,492 没有评论


大半天时间整理的PHP编码规范…

一、命名规范:

1. 常量的命名

1) 字母,全部大写,使用“_” 分隔单词

如:DEFINE(“PHP_DEMO_PRINT”,”hEllo world”);

2. 变量的命名

1) 使用驼峰结构命名,即以小写字母开头,从第二个单词开始,每个单词的第一个字母大写。

如:$getElement=”myodbc”;

2) 全局变量以“g_”开头,非全局变量不要以“g_”开头

如:$g_i;

3) 所有的“临时”变量使用完毕后必须unset

4) 不允许出现字母完全相同,仅大小写不同的命名。

5) 不允许在命名的结尾使用下划线。

6) 不要出现单字母的变量,如i,j,k(只有在控制循环数时且循环代码条数在3条以内,才可以考虑使用)

7) 变量名中不能出现数字。

8) 变量名最好能表示出是数值型还是字符串型变量。

如:$myCount_i表示数值型变量,$myString_s表示字符串。

9) 如果有计算限定符,把限定词加到名字的最后。

如:$calTimeStart 、 $calTimeEnd.

 

3. 函数的命名

1) 函数名全部小写,单词之间可以使用下划线。

2) 存取对象的函数名使用 set_xxx() 和get_xxx() 形式。

3) 布尔类型的函数名可以使用 isxxx() 形式。

4) 函数名中不能出现数字。

 

4. 类命名

1) 类名用第一个字母大写的英文正常语序准确描述类的含义。如:Employee

2) 类的方法命名规则与函数的命名规则一致。

3) 类的属性名采用全字母小写。

 

5. 文件的命名

1) 文件名字符全部采用小写

2) 文件名称要能反映出其内容及功能。

如:储存有类的文件,name.class.php;存有函数的文件可采用name.func.php或name.inc.php来命名;配置文件,name.cfg.php或者config.inc.php 。

 

二、注释规范:

1. 变量的注释

1) 变量的同行后空一格使用双斜线注释。

如:$myDemo = ‘a demo’; //这是行内注释

 

2. 函数与函数体的注释

/*

@作者:xxxxbbb

*/

//描述函数的功能和返回值和引用方法

function  ff(aaa, bbb)  {

……

// 普通夹杂在代码里的单行注释

……

return false;

}

 

3. 文件的注释

1) 文件功能、创建人信息、时间。

2) 已知的Bug。当然最好是修正所有错误,但可能暂时还没有办法修正错误,或暂时没有精力去修改

3) 开发和维护文件的历史列表。记录每一次修改的作者、日期、修改的内容

4) 对主要的算法必须加以解释说明,主要的流程必须给出引导性的说明

5) 标准格式

/**

* @description 描述类的功能、用途、现存BUG,设计方法。

* @author 作者姓名

* @version 最后修改日期(日期格式建议采用:年日格式,例如:2008-04-05

*/

如果对已经版本化的类进行了修改,需要按照如下格式为每一次修改附加修改历史记录:

* @modify

修改人 + 修改日期(日期格式建议采用:年日格式,例如:2008-04-05

修改说明

 

 

三、代码书写风格

1. 总原则

1) 一行代码尽量简短,并且保证一行代码只做一件事。

2) 使用圆括号来界定操作的顺序。不要让别人判断复杂的操作优先级。

3) 合理使用空行,划分逻辑处理。

4) 代码缩进使用TAB(设定四个空格)

5) 建议遵循三十秒原则。如果另一个程序员无法在三十秒之内了解你的函数做了什么,如何做以及为什么要这样做,那就说明你的代码是难于维护的,必须得到提高。

 

2. 控制结构

 

1) If 规范

1. else 后面的if,另起一行 

2. 把对比常量,放在等式左边 

3. 分支要加上注释,注释前面加一个(TAB)缩进

 

if (6 == $errorNum)  { //注释1

..

}  else  {

if (5 == $num)  { //注释2

}  else  {

}

}

 

2) Switch规范

switch (…) {

case 1: //分支1注释

…   

// 这里没有break,直接转到下个case,须要加注释   

case 2:  {  //分支2注释  

$v = get_week_number(); // 创立变量,在{}之中   

…  

   

break;    

default:  

}

 

3) For规范

For($i=1;$i<=3;$i++)  {

……

}

4) While 规范

While ($i<=5) {

….

}

 

5) Foreach  规范

 

Foreach ($arr  as  $v => $k)  {

….

}

 

四、代码书写风格

1. 使用$row[id]方式取数据,不要使用$row[id]方式。

2. 纯字符串使用单引号包含。

3. 删除未使用的变量

4. 执行for循环之前确定最大循环数,不要每循环一次都计算最大值。

5. 循环内部不要声明变量,尤其是大变量:对象(语言通用)

6. 执行字符串替换前用strpos()函数判断是否存在后再执行替换函数。

7. 用foreach代替while遍历数组。遍历数组时foreach的效率明显高于while循环

8. str_replace函数比preg_replace函数快,但strtr函数的效率是str_replace函数的四倍

9. 当执行变量$i的递增或递减时,$i++会比++$i慢一些。这种差异是PHP特有的

10. 用@屏蔽错误消息的做法非常低效。

       

本文采用知识共享署名-非商业性使用 3.0 中国大陆许可协议进行许可,转载时请注明出处及相应链接。

本文永久链接: https://www.zh30.com/php-coding-standards-document.html

发表评论

change vcode