5.PHP编码规范.docxVIP

无线-手机微博-架构组编码规范（PHP）目录1文件11.1文件名11.2格式22排版22.1空行22.2缩进32.3空格32.4换行52.5对齐72.5.1数组72.5.2双元运算符83命名约定83.1面向过程83.2面向对象94注释规范114.1常用标记124.2文件注释124.3函数注释124.4类的属性注释134.5变量注释135通用规定135.1引号135.2递增/递减运算符145.3变量145.4循环条件值15文件文件名文件名一律小写，合成名词采用下划线分离，如：jump_link.phpsample_feedback.phpsample_push.php文件名中标识类型，如：serialize.class.php类文件exception.class.php类文件article.conf.php配置文件channel.model.php模块文件core.inc.php包含文件模板文件已.tpl结尾，如：index.tpl错误的命名方式如下：jumpLink.phpsamplefeedback.phpSamplePush.phpserialize.php类文件exception.php类文件article.php配置文件channel.php模块文件core.php包含文件格式文件统一使用UTF8编码；文件开头不得有BOM，类似Notepad这样的编辑器在保存时默认会含有BOM，建议使用Editplus、UltraEditor和Eclipse等编辑器进行编辑；PHP代码文件开头?php必须是从第一行第一个字符开始，不得使用?；对于只包含有PHP代码而无别的代码的文件，结束标志“?”不允许存在的；请将编辑器设置对所有程序使用UNIX格式保存，不要使用Win32或者Mac的格式。排版空行每段逻辑（函数、循环）结束后，输入空行；如果函数内部行数很多，酌情按实际情况添加空行方便阅读。规范格式如下：function my_function($a, $b){echo $a;}if ($a == $b){ my_function($a);}$myClass = new MyClass();$myClass-myFunction($a, $b);$myClass-select(self::TABLE_CHANNEL, NULL, array(url = ));echo 正确;错误格式如下：function my_function($a, $b){echo $a;}此处必须添加空行if ($a == $b){ my_function($a);}$myClass = new MyClass();$myClass-myFunction($a, $b);此处建议添加空行$myClass-select(self::TABLE_CHANNEL, NULL, array(url = ));echo 错误;缩进使用制表符对代码进行缩进控制；制表符使用4个空格代替。空格操作符两侧需留有空格；规范格式如下：$version += 1 ;print time() . sending message\n;错误格式如下：操作符两端必须添加空格$version+=1;print time(). sending message\n;参数后紧跟,，逗号后留有空格；规范格式如下：stream_context_set_option($ctx, ssl, local_cert, blog.pem);错误格式如下：stream_context_set_option($ctx,ssl,local_cert,blog.pem);数组?左右留有空格；规范格式如下：$aps = array(alert = Hello World);错误格式如下：$aps = array(alert=Hello World);关键字（if、for、while等）后，留一个空格再跟左括号 ’(’；规范格式如下：if (!empty($this-_fields)){ $result = array(); $fieldsCount = count($this-_fields);for ($i = 0; $i $fieldsCount; $i++) { $result[$this-_fields[$i]] = $this-_rediska-getSerializer()-unserialize($response[$i]); }return $result;}else{return $this-_rediska-getSerializer()-unserialize($response);}错误格式如下：if(!empty($this-_fields))