编辑“HDWiki/编码规范”

{{HDWiki top}}
==命名规范==
1、主要的目录 control 里面是控制类 ,前台命名为something.php,则后台对应的是admin_+前台名称,名称应选有意义的英文单词,例如 前台词条 doc.php ，后台词条管理对应的 admin_doc.php 

2、model目录下个文件是功能模块,命名以 control名称+".class.php" ，例如control中doc.php对应是 doc.class.php 

3、view 是视图类，前台某功能命名为主,如login.htm,space.htm等,若不好命名,以"动词"+"control名称",例如浏览词条可命名为viewdoc.htm,后台命名统一加上admin_前缀,如admin_login.htm 、admin_index.htm等 

4、lib目录下为基础类,命名用个类的名称为主,如hddb.class.php 、xml.class.php、json.class.php 等 

5、文件名全部小写，类名，类的方法名全部小写。

6、变量名称应使用有意义的小些英文单词或组合命名,中间无任何分隔符,如$doc,$user,$category,$onlineip等等,勿使用拼音或者无意义的$temp,$data等来给变量命名

7、常量全部用大写字母，"HDwiki_有意义的英文单词或组合",如define('HDwiki_VERSION', '1.0.0');

8、一些列表[[数据]]采用“名词+list”,如词条列表数据的变量名使用$doclist,用户列表数据的变量使用$userlist等

9、函数或者类的方法命名用小写的英文单词或组合命名,如是组合请用下划线_分割,如 function parse(),function add_doc(),function get_user()等

==开发规范==
1、所有的[[url]]都是从 index.php? 开始的,第一个参数是调用的控制器，第二个参数是方法名字，第三个以后的都是方法的参数,例如index.php?doc-view-1 表示 调用/control/doc.php的doview方法,1是该方法的参数

2、删除无用的注释，包括无用的函数和方法。

3、if语句格式 :需要用大括号，即使只有一句话,例如if(a) echo 'a'; => if(a) { echo 'a'; }

4、缩进格式，采用TAB方式缩进

5、保证各方法需要有返回值时做有返回值处理,不需要时勿返回值,保证程序异常处理

6、杜绝在for循环中调用本可以一次调用的函数或方法如：
<pre>
for($i=0,$con=count($order);$i<$con;$i++){
$this->db->query("update ".DB_TABLEPRE."friendlink set displayorder=".$i." where id=".$order[$i]);
}
</pre>
7、不需要赋值的地方请勿赋值 如
<pre>
function addlink($link){
$query = $this->db->query("INSERT INTO ".DB_TABLEPRE."friendlink (name,url,description) 
VALUES ('$link[name]','$link[url]','$link[description]')");
}
</pre>
直接写成如下方式即可：
<pre>
function addlink($link){
$this->db->query("INSERT INTO ".DB_TABLEPRE."friendlink (name,url,description) 
VALUES ('$link[name]','$link[url]','$link[description]')");
}
</pre>
8、若中间数据可直接返回,请勿再次赋值如：
<pre>
function get_pms($id){
$pms=$this->db->fetch_first("SELECT * table");
return $pms;
}
</pre>
直接改为：
<pre>
function get_pms($id){
return $this->db->fetch_first("SELECT a. * ,b.username FROM ".DB_TABLEPRE."pms a,".DB_TABLEPRE."
user b where a.toid=b.uid and a.id='".$id."'");
}
</pre>
9、[[SQL]]语句中：sql关键字大写、表名小写。sql语句坚决不用子查询。不用存储过程、不用外键、不用触发器等。记录数，采用 select count(*) from 表名 的方式

10、函数内的局部变量在函数的第一句开始处定义。

11、函数和函数之间空一行。

12、大括号格式
<pre>
function get_lastdoc($docid,$doctime){;
}
</pre>
13、写法 <nowiki>if($type=='')</nowiki> 改为 <nowiki>if(''==$type)</nowiki>

==参考来源==
http://kaiyuan.hudong.com/

{{HDWIKI}}

[[category:HDWiki|B]]