php 编码规范.docVIP

PHP编码格式规范 版本：1.0 历史： * v1.0 2009.01.19运营商管理组 - 参考互动社区的编码规范，制定此规范 为什么有编码格式规范？ 格式化代码为了让代码更容易阅读 格式化代码有益于改善代码质量 格式化代码是使代码被可持续维护的保障 格式化代码是一个优秀的程序员认真负责态度的体现 格式化代码是对阅读你代码读者礼貌的体现 因此，我们需要你必须这么做….. 缩进(Indentation) 用什么来缩进？缩进多少？ 缩进让代码更容易阅读 使用制表符(Tab)缩进 请将制表符的缩进位置设置为4 function func() { if ($i 10) { if ($j 100) { while ($k 1000) { …… } } } } 空白字符(Wrapping Lines) 函数名后的” ()”无空格 函数的多个参数之间加空格，括号前后无空格 正确: list($user, $pass) = explode(:, Iuser:Nopass) 错误: List ($user, $pass) = explode (:, Iuser:Nopass) list($user,$pass) = explode(:,Iuser:Nopass) list( $user, $pass) = explode( :, Iuser:Nopass) list($user, $pass ) = explode(:, Iuser:Nopass ) 赋值操作符、比较操作符、算术操作符、逻辑操作符、位域操作符，如“=”、“+=” “=”、“=”、“+”、“*”、“%”、“”、“||”、“”,“^”等二元操作符的前后加空格 一元运算符、地址运算符“!”、“~”、“++”、“--”、“”等前后无空格 “-”， “::”操作符前后不加空格 正确: $c = $a + $b; $c++; $book = new book; $book-getName(); 错误: $c=$a+$b; $c =$a +$b; $c ++; $book = new book; $book - getName(); 数组以=分隔键值对，则写成单行，上下的等号对齐； 只要值的数组写成一行，则每项之间应该有空格 正确: $c = array( “user” = ‘user’, “passwd” = ‘passwd’, ); $c = array(“bank”, “card”); 行末不要保留没有意义的空格符。Zend设置：Tool-Preferences-Editing-Strip trailing spaces on save 换行结束符(Lines) 为保持语句清晰，每一行只写一个语句 两个片段(section)之间，使用空行隔开，函数/方法之间使用一个空行隔开，类声明之间使用两个空行隔开 interface MyInterface { public function ifc1(){} public function ifc2(){} } class Foo extends MyInterface { private function foo1() { …… } public function foo2() { …… } } php代码起始格符，请严格使用”?php “作为程序的第一行开始 括号(Parenthesis) 大括号(花括号) ”{” 怎么对齐？ 将大括号放置在关键词下方的相同的位置 正确: foreach ($mydata as $key = $value) { …… } 错误: foreach ($mydata as $key = $value){ …… } 注释(Comments) 单行怎么注释？ 在语句结尾用双反斜杠”// “注释 多行怎么注释？ 多行注视以”/*”符号开头，以”*/ “符号作为注释结束符 /* 这是一段注释，这里需要描述很多内容: 从前有座山，山上有个老和尚 有一天老和尚对小和尚说… */ 文件、类、函数的头注释怎么写？ 符合phpdoc标准 的写法，参见《phpdoc注释规范指南》 /** * Copyright (c) 2009, 新浪网支付中心 * All rights reserved. * 文件名称： index.php * 摘 要： 首页程序 * 作 者： xxx * 版 本： 1.0 * 修改日期