• 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)

  • 相关阅读:
    OKR让你的目标杜绝“虎头蛇尾”
    OKR让你的团队更加优秀
    个人与企业OKR如何做好联结(三)
    OKR的最佳状态不是满分
    Tita OKR:目标地图的妙用
    个人与企业OKR如何做好联结(四)
    函数可以替换成过滤器demo
    @click传递事件和参数
    vue组件
    watch与computed区别
  • 原文地址:https://www.cnblogs.com/camelroyu/p/5640843.html
Copyright © 2020-2023  润新知