PHP编码规范【DOC精选】.doc

PHP编码规范 编码规范 1 1. 引言 1 2. 适用范围 2 3. 标准化的重要性和好处 2 4. PHP编码规范与原则 2 4.1. 代码标记 2 4.2. 注释 2 4.3. 书写规则 3 4.3.1. 缩进 3 4.3.2. 大括号{}、if和switch 3 4.3.3. 运算符、小括号、空格、关键词和函数 4 4.3.4. 函数定义 5 4.3.5. 引号 6 4.4. 命名原则 6 4.4.1. 变量、对象、函数名 7 4.4.2. 常量 7 4.5. 变量的初始化与逻辑检查 7 4.6. 安全性 8 4.7. 兼容性 8 4.8. 代码重用 8 4.9. 其他细节问题 9 4.9.1. 错误报告级别 9 引言 本规范由编程原则组成，融合并提炼了开发人员长时间积累下来的成熟经验，意在帮助形成良好一致的编程风格。以达到事半功倍的效果，如果有需要本文档会不定期更新。 传播： 仅供公司内部交流。未经许可，禁止传播、转载和发表 适用范围 Php项目开发。 标准化的重要性和好处 当一个软件项目尝试着遵守公共一致的标准时，可以使参与项目的开发人员更容易了解项目中的代码、弄清程序的状况。使新的参与者可以很快的适应环境，防止部分参与者出于节省时间的需要，自创一套风格并养成终生的习惯，导致其它人在阅读时浪费过多的时间和精力。而且在一致的环境下，也可以减少编码出错的机会。缺陷是由于每个人的标准不同，所以需要一段时间来适应和改变自己的编码风格，暂时性的降底了工作效率。从使项目长远健康的发展以及后期更高的团队工作效率来考虑暂时的工作效率降低是值得的，也是必须要经过的一个过程。标准不是项目成功的关键，但可以帮助我们在团队协作中有更高的效率并且更加顺利的完成既定的任务。 程序员可以了解任何代码，弄清程序的状况 新人可以很快的适应环境 防止新接触PHP的人出于节省时间的需要，自创一套风格并养成终生的习惯 防止新接触PHP的人一次次的犯同样的错误 在一致的环境下，人们可以减少犯错的机会 程序员们有了一致的敌人 PHP编码规范与原则 代码标记 PHP程序可以使用?php ?或? ?来界定 PHP 代码，在HTML页面中嵌入纯变量时，可以使用?=$variablename?这样的形式。 近年来PHP开发组一直倡导代码规范化和标准化，未来版本PHP可能会开始不建议使用甚至取消? ?和?=$variablename?这种速记形式，届时本文档也将进行跟进修改。 注释 注释是对于那些容易忘记作用的代码添加简短的介绍性内容。请使用 C 样式的注释“/* */”和标准 C++ 注释“//”。 在Discuz!每一个程序文件头部中，应放入相应CVS控制字串，以方便CVS提交时自动更新： $RCSfile$ 程序文件名 $Revision$ 修订版本号 $Date$ 最后更新时间 例如： /* [DODI] (C)2001-2006 Comsenz Inc. This is NOT a freeware, use is subject to license terms $RCSfile: forumdisplay.php,v $ $Revision: 1.7 $ $Date: 2006/02/23 13:44:02 $ */ 程序开发中难免留下一些临时代码和调试代码，此类代码必须添加注释，以免日后遗忘。所有临时性、调试性、试验性的代码，必须添加统一的注释标记“//debug”并后跟完整的注释信息，这样可以方便在程序发布和最终调试前批量检查程序中是否还存在有疑问的代码。例如： $num = 1; $flag = TRUE; //debug 这里不能确定是否需要对$flag进行赋值 if(empty($flag)) { //Statements } 书写规则 缩进 每个缩进的单位约定是一个TAB(8个空白字符宽度)，需每个参与项目的开发人员在编辑器(UltraEdit、EditPlus、Zend Studio等)中进行强制设定，以防在编写代码时遗忘而造成格式上的不规范。 本缩进规范适用于PHP、JavaScript中的函数、类、逻辑结构、循环等。 大括号{}、if和switch 首括号与关键词同行，尾括号与关键字同列； if结构中，else和elseif与前后两个大括号同行，左右各一个空格。另外，即便if后只有一行语句，仍然需要加入大括号，以保证结构清晰； switch结构中，通常当一个case块处理后，case块处理，if($condition) { switch($var) { case 1: echo ‘var is 1’; break; case 2: echo ‘var is 2’; break; d