公司代码规范

xcore框架目录

├─vendor     扩展目录(在这个目录可以使用composer 安装插件)
├─library     框架核心目录
│  ├─db      封装的底层数据库操作类
│  ├─my     封装常用功能静态类
│  ├─Function.php     通用函数
│  ├─G.php     全局变量
├─common     通用模型(涉及到数据库)

框架支持:

• 命名空间,支持composer
• 多域名部署
• 分布式环境支持(cookie入库)
• php7以上
• mysqli

项目目录结构

www  WEB部署目录
├─application     应用目录
│  ├─autoload     自动加载
│  │  ├─function.php     项目函数文件
│  ├─common     公共模型目录
│  │  ├─model     业务模型(不用事务)
│  │  ├─server     业务模型(使用事务)
│  ├─config     配置目录
│  │  ├─adminmenu.php     后台目录配置文件
│  │  ├─type.php     业务配置文件
│  ├─admin     后台模块
│  ├─www     前台模块
├─public     WEB目录（对外访问目录）
│  ├─static     静态文件目录
│  ├─index.php     入口文件
│  └─.htaccess     用于apache的重写

编写规范

• 命名原则, 能够表达语义. 选择简单的单词
• 目录小写；
• 所有Php文件,首字母大写, 里面的类名和文件名保持一致
• 函数名称, 下划线/驼峰.
• 数据库建表规范,表名用常用英文单词. 索引固定写id, 关联字段,用关联表加下划线id
• 业务配置规范, 数据库表名_字段名 (简单通用的可以直接用简写)
• controller名称与数据库表保持一致
• controller固定方法名称, lists, add, edit, detail, del, delall
• 模板和提交数据共用一个方法名称 用is_post() 函数区分开

程序文件目录

controller: 参数验证, 代码业务逻辑
model: 封装复杂的业务逻辑
server: 有事务的业务逻辑
view: 模板

服务器图片处理

每次编辑,更新,删除都要对业务的图片进行处理

#添加/编辑文章时, 处理文章图片, $d是文章入库字段
m('Attachment','xcom')->imgSure('article',$id,$d); 
#删除文章,同时删除图片
m('Attachment','xcom')->imgDel('article',$d['id'],true);

调用模型

#调用非事务模型
m(模型名称, 'c')->方法名称();
#调用事务模型
s(模型名称, 'c')->方法名称();

db函数的使用

#组装条件搜索
$map = [['and','id','=', 1]];
$w  = where($map);
$rs = $this->db->query("select * from user $w[0]",$w[1]);
#搜索多条
$rs = $this->db->query("select * from user where status=?",[0]);
#搜索单条
$rs = $this->db->query("select * from user where status=?",[0],1);
#插入数据
$data = ['name'=>'张三', 'status'=>0];
$id  = $this->db->insert('user', $data);
#更新数据
$data = ['id'=>1,'name'=>'张三', 'status'=>0];
$this->db->update('user', $data);


#搜索多条,并返回数据库总条数
$rs = $this->db->query("select * from user where status=?",[0],'',true);

#快捷方法
find, update, select, insert, insertAll #sql快捷方式,使用时注意他们的参数

显示模板

$this->fetch([键值对]);

验证参数

            $d = $this->post;
            $rule = [
                'title'=>'require',
            ];
            $msg = [
                'title.require'=>'请填写标题',
            ];
            check($rule,$msg,$d);

post返回函数

if(is_post()){
    suc([键值对数据]);#成功返回
    err('错误提示语句');#失败返回
}

注意事项

• 1,数据库全部使用 $this->db; 不要使用db()函数否则导致事务失败
• 2,controller 一定要验证表单
• 3,涉及到图片的表单一定要使用通用附件模型. Attachment. 否则图片会被删除
• 4, 复用的, 逻辑比较多的, 涉及事务的. 要写成server

代码协作使用git

git init
git add remote xxx master
git add .
git commit -m '修改备注'
git pull xxx master
git push xxx master
git branch v2 

具体使用,内部团队沟通....
xcore® 版权所有 xielisen。