PHPCMS中的PHP编码规范

《PHPCMS中的PHP编码规范》由会员上传分享，免费在线阅读，更多相关内容在应用文档-天天文库。

1、PHPCMS中的PHP编码规范注：这是从PHPCMS开发文档里看到编码规范，虽名为PHPCMS的开发规范，但我觉得所有的PHP编程都该如此。写了那么多PHP，很多编码对照这规范都感觉欠缺很多，今后一定要对照纠正。Phpcms编码规范1.引言….22.适用范围….23.标准化的重要性和好处….34.PHP编码规范与原则….34.1.代码标记…34.2.注释…34.3.书写规则…44.3.1.缩进…44.3.2.大括号{}、if和switch.44.3.3.运算符、小括号、空格、关键词和函数…54.3.4.函数

2、定义…64.3.5.引号…64.3.6.多语言问题…74.4.命名原则…84.4.1.变量、对象、函数名…84.4.2.常量…84.5.变量的初始化与逻辑检查…84.6.安全性…94.7.兼容性…94.8.代码重用…104.9.其他细节问题…104.9.1.包含调用…104.9.2.错误报告级别…115.数据库设计….115.1.字段…115.1.1.表和字段命名…115.1.2.字段结构…115.2.SQL语句…125.3.性能与效率…135.3.1.定长与变长表…135.3.2.运算与检索…135.3.

3、3.结构优化与索引优化…145.3.4.查询优化…145.3.5.兼容性问题…166.模板设计….166.1.代码标记…166.2.书写规则…166.2.1.HTML.166.2.2.变量…166.2.3.语言元素…176.2.4.缩进…177.文件与目录….177.1.文件命名…177.2.目录命名…187.3.空目录索引…181.引言本规范由编程原则组成，融合并提炼了开发人员长时间积累下来的成熟经验，意在帮助形成良好一致的编程风格。以达到事半功倍的效果，如果有需要本文档会不定期更新。版权：陕西玖肆陆陆网

4、络科技有限公司，保留所有权利最后更新日期：年11月20日20062.适用范围如无特殊说明，以下规则要求完全适用于phpcms项目，同时也可大部分适用于公司其他PHP项目。3.标准化的重要性和好处当一个软件项目尝试着遵守公共一致的标准时，可以使参与项目的开发人员更容易了解项目中的代码、弄清程序的状况。使新的参与者可以很快的适应环境，防止部分参与者出于节省时间的需要，自创一套风格并养成终生的习惯，导致其它人在阅读时浪费过多的时间和精力。而且在一致的环境下，也可以减少编码出错的机会。缺陷是由于每个人的标准不同，所

5、以需要一段时间来适应和改变自己的编码风格，暂时性的降底了工作效率。从使项目长远健康的发展以及后期更高的团队工作效率来考虑暂时的工作效率降低是值得的，也是必须要经过的一个过程。标准不是项目成功的关键，但可以帮助我们在团队协作中有更高的效率并且更加顺利的完成既定的任务。1.程序员可以了解任何代码，弄清程序的状况2.新人可以很快的适应环境3.防止新接触PHP的人出于节省时间的需要，自创一套风格并养成终生的习惯4.防止新接触PHP的人一次次的犯同样的错误5.在一致的环境下，人们可以减少犯错的机会6.程序员们有了一致

6、的敌人4.PHP编码规范与原则4.1.代码标记PHP程序可以使用或来界定PHP代码，在HTML页面中嵌入纯变量时，可以使用这样的形式。近年来PHP开发组一直倡导代码规范化和标准化，未来版本PHP可能会开始不建议使用甚至取消和这种速记形式，因此为了加强程序兼容性，在发布之前我们将统一把4.2.注释注释是对于那些容易忘记作用的代码添加简短的介绍性内容。请使用C样式的注释“/**/”和标准C++注释“//”。程序开发中难免留下一些临时代码和调试代码，此类代码必须添加注释，以免日后遗忘。所有临时性、调试性、试验性的

7、代码，必须添加统一的注释标记“//debug”并后跟完整的注释信息，这样可以方便在程序发布和最终调试前批量检查程序中是否还存在有疑问的代码。例如：$num=1;$flag=TRUE;//debug这里不能确定是否需要对$flag进行赋值if(empty($flag)){//Statements}4.3.书写规则4.3.1.缩进每个缩进的单位约定是一个TAB(8个空白字符宽度)，需每个参与项目的开发人员在编辑器(UltraEdit、EditPlus、ZendStudio等)中进行强制设定，以防在编写代码时遗忘

8、而造成格式上的不规范。本缩进规范适用于PHP、JavaScript中的函数、类、逻辑结构、循环等。4.3.2.大括号{}、if和switch首括号与关键词同行，尾括号与关键字同列；if结构中，if和elseif与前后两个圆括号同行，左右各一个空格，所有大括号都单独另起一行。另外，即便if后只有一行语句，仍然需要加入大括号，以保证结构清晰；switch结构中，通常当一个case块处理后，将跳过之后的case块处理，