hdwiki 编码规范

编码规范

命名规范

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

1.2、model目录下个文件是功能模块,命名以 control名称+".class.php" ，例如control中doc.php对应是 doc.class.php
1.3、view是视图类，前台某功能命名为主,如login.htm,space.htm等,若不好命名,以"动词"+"control名称",例如浏览词条可命名为viewdoc.htm,后台命名统一加上admin_前缀,如admin_login.htm 、admin_index.htm等
1.4、lib目录下为基础类,命名用个类的名称为主,如hddb.class.php 、xml.class.php、json.class.php 等
1.5、文件名全部小写，类名，类的方法名全部小写。
1.6、变量名称应使用有意义的小些英文单词或组合命名,中间无任何分隔符,如$doc,$user,$category,$onlineip等等,勿使用拼音或者无意义的$temp,$data等来给变量命名
1.7、常量全部用大写字母，"HDwiki_有意义的英文单词或组合",如define('HDwiki_VERSION', '1.0.0');
1.8、一些列表数据采用“名词+list”,如词条列表数据的变量名使用$doclist,用户列表数据的变量使用$userlist等
1.9、函数或者类的方法命名用小写的英文单词或组合命名,如是组合请用下划线_分割,如 function parse(),function add_doc(),function get_user()等

开发规范
2.1、所有的url都是从 index.php? 开始的,第一个参数是调用的控制器，第二个参数是方法名字，第三个以后的都是方法的参数,例如index.php?doc-view-1 表示 调用/control/doc.php的doview方法,1是该方法的参数
2.2、删除无用的注释，包括无用的函数和方法。
2.3、if语句格式 :需要用大括号，即使只有一句话,例如if(a) echo 'a'; => if(a) { echo 'a'; }
2.4、缩进格式，采用TAB方式缩进
2.5、保证各方法需要有返回值时做有返回值处理,不需要时勿返回值,保证程序异常处理
2.6、杜绝在for循环中调用本可以一次调用的函数或方法如：
for($i=0,$con=count($order);$i<$con;$i++){
$this->db->query("update ".DB_TABLEPRE."friendlink set displayorder=".$i." where id=".$order[$i]);
}
2.7、不需要赋值的地方请勿赋值 如
function addlink($link){
$query = $this->db->query("INSERT INTO ".DB_TABLEPRE."friendlink (name,url,description) VALUES ('$link[name]','$link[url]','$link[description]')");
}
直接写成如下方式即可：
function addlink($link){
$this->db->query("INSERT INTO ".DB_TABLEPRE."friendlink (name,url,description) VALUES ('$link[name]','$link[url]','$link[description]')");
}
2.8、若中间数据可直接返回,请勿再次赋值如：
function get_pms($id){
$pms=$this->db->fetch_first("SELECT * table");
return $pms;
}直接改为：
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."'");
}
2.9、sql语句中：sql关键字大写、表名小写。sql语句坚决不用子查询。不用存储过程、不用外键、不用触发器等。记录数，采用 select count(*) from 表名 的方式
2.10、函数内的局部变量在函数的第一句开始处定义。
2.11、函数和函数之间空一行。
2.12、大括号格式
function get_lastdoc($docid,$doctime){;
}
2.13、写法 if($type=='') 改为 if(''==$type)