2012php开发规范文档

《2012php开发规范文档》由会员上传分享，免费在线阅读，更多相关内容在工程资料-天天文库。

1、PHP开发规范文档V1.0江西掌讯科技有限公司二零一二年一月本文档及其所含信息为机密材料并且由江西掌讯科技有限公司(PM-TECH)拥有未经PM-TECH书而授权，不得将材料泄露给第三方Copyright©2012PM-TECH版权保留所有的权利1引言32PHP编码规范与原则42」代码标记42.2注释42.3书写规则52.3.1缩进52.3.2大扌舌号｛｝、ifswitch52.3.3函数62.4命名规则72.5代码重用81引言木规范由编程原则组成，融合并提炼了开发人员长时间积累下來的成熟经验,意在帮助形成良好一致的编程风格。以达到事半功倍的效果，如果

2、有需要本文档会不定期更新。当一个软件项目尝试着遵守公共一致的标准时，可以使参与项目的开发人员更容易了解项目中的代码、弄清程序的状况。使新的参与者可以很快的适应环境,防止部分参与者出于节省时间的需要，口创一套风格并养成终生的习惯，导致其它人在阅读时浪费过多的时间和精力。而且在一致的环境下，也可以减少编码出错的机会。缺陷是由于每个人的标准不同，所以需要一段时间来适应和改变自己的编码风格，暂时性的降底了工作效率。从使项目长远健康的发展以及后期更高的I才I队工作效率来考虑暂吋的工作效率降低是值得的，也是必须要经过的一个过程。标准不是项目成功的关键，但可以帮助我

3、们在团队协作中有更高的效率并且更加顺利的完成既定的任务。•程序员可以了解任何代码，弄清程序的状况•新人可以很快的适应环境•防止新接触PHP的人出于节省时间的需要，自创一套风格并养成终生的习惯•防止新接触PHP的人一次次的犯同样的错误•在一致的环境下，人们可以减少犯错的机会2PHP编码规范与原则2.1代码标记PHP程序可以使用v?php?＞或v??＞來界定PHP代码，在HTML页面中嵌入纯变量吋，可以使用＜?=$variablename?＞这样的形式。近年来PHP开发组一直倡导代码规范化和标准化，未来版本PHP可能会开始不建议使用其至取消V??＞和＜?=

4、$variablename?＞这种速记形式，届时本文档也将进行跟进修改。2.2注释注释是对于那些容易忘记作用的代码添加简短的介绍性内容。请使用C样式的注释“/**/”和标准C++注释“//”O第一种、页面级别的注释，说明每个页面做什么处理*描述：*开发吋间:*开发人：*开发单位:客八实体化完成率录入2011-05-26易旭晖江西掌讯科技有限公司第二种、函数、类成员方法的需有注释Qfunction写操作口志Qauthor易旭晖Aversion1-0-0Qparam$a菜单代码$b用八名$c备注$d操作类型^return操作类型0:查看1:增加2:删除4:

5、修改8:登录9:登出functionwrite_log($a,$b,$c=101,$d=11,$e=11){2.3书写规则2.3.1缩进每个缩进的单位约定是一个TAB(8个空白字符宽度)，需每个参与项目的开发人员在编辑器(UltraEdit.EditPlus>ZendStudio等)中进行强制设定，以防在编写代码时遗忘而造成格式上的不规范。2.3.2大括号{}*if和switch不允许在新的一行上写开口括号【左大括号】，请在行尾写。〃错误的示例if(...){•••}else{•••}〃正确的示例if(...){•••}else{•••}//错误的示例

6、functiontest(){}//正确的示例functiontest(){•••}关键字、语句、表达式两边齐使用一个空格，便于阅读//错误的示例if(...){•••}〃正确的示例if(...){//错误的示例$var="aaa";〃正确的示例$var="aaa'switch中break和内容对齐//错误的示例-switch($test){caseQ:return，ok';break;}//正确的示例switch($test){case'a/:return

7、，这个整体的两边需要有各有一个空格，然后参数列表里，每个参数相对前一个参数需耍有二个空格。//错误的示例functionupdateRecords(Stable,$parameters,$conditions){//正确的示例functionupdateRecords($table,$parameters,$conditions){有默认值的参数应放在参数列表最后面，赋值等号两边应该各有一个空格。//错误的示例functionupdate($table二W,$parameters,$conditions){•••}//正确的示例functionupda

8、te($pafameters,$conditions,Stable=W){•••}2.4命名规