CRMEB|CRMEB PRO 手册
CRMEB PRO
运行环境要求PHP7.1 ~ 7.3。开发规范 命名规范 ThinkPHP6.0遵循PSR-2命名规范和PSR-4自动加载规范,并且注意如下规范:
- 目录和文件
- 目录使用小写+下划线;
- 类库、函数文件统一以.php为后缀;
- 类的文件名均以命名空间定义,并且命名空间的路径和类库文件所在路径一致;
- 类(包含接口和Trait)文件采用驼峰法命名(首字母大写),其它文件采用小写+下划线命名;
- 类名(包括接口和Trait)和文件名保持一致,统一采用驼峰法命名(首字母大写);
- 类的命名采用驼峰法(首字母大写),例如 User、UserType;
- common函数的命名使用小写字母和下划线(小写字母开头)的方式,例如 get_client_ip;
- 控制器里面的方法使用小写字母和下划线(小写字母开头)的方式,例如 get_client_ip
- 方法的命名使用驼峰法(首字母小写),例如 getUserName;
- 属性的命名使用驼峰法(首字母小写),例如 tableName、instance;
- 特例:以双下划线__打头的函数或方法作为魔术方法,例如 __call 和 __autoload;
- 常量以大写字母和下划线命名,例如 APP_PATH;
- 配置参数以小写字母和下划线命名,例如 url_route_on 和url_convert;
- 环境变量定义使用大写字母和下划线命名,例如APP_DEBUG;
- 数据表和字段采用小写加下划线方式命名,并注意字段名不要以下划线开头,例如 think_user 表和 user_name字段,不建议使用驼峰和中文作为数据表及字段命名
语法规范
- 尽量使用php7新语法
- 每个 namespace 命名空间声明语句和 use 声明语句块后面,必须 插入一个空白行
- 类的开始花括号({) 必须 写在类声明后自成一行,结束花括号(})也 必须 写在类主体后自成一行
- 方法的开始花括号({) 必须 写在函数声明后自成一行,结束花括号(})也 必须 写在函数主体后自成一行。
- 类的属性和方法 必须 添加访问修饰符(private、protected 以及 public),abstract 以及 final 必须 声明在访问修饰符之前,而 static 必须 声明在访问修饰符之后
- 控制结构的关键字后 必须 要有一个空格符,而调用方法或函数时则 一定不可 有
- 控制结构的开始花括号({) 必须 写在声明的同一行,而结束花括号(}) 必须 写在主体后自成一行
- 纯 PHP 代码文件 必须 省略最后的 ?> 结束标签
- 所有方法,类,控制器类,都 必须 添加访问修饰符
/** * 中文注释 * @param string $str 声明类型 * @param array $arr * @return bool */ public function action(string $str, array $arr) { return true; }
- 参数列表中,每个逗号后面 必须 要有一个空格,而逗号前面 一定不可 有空格
function foo($arg1, &$arg2, $arg3 = []) { // method body }
- 参数 可以 分列成多行,此时包括第一个参数在内的每个参数都 尽量 单独成行。
bar( $longArgument, $longerArgument, $muchLongerArgument );
- 标准的 if 结构如下代码所示,请留意「括号」、「空格」以及「花括号」的位置,
注意 else 和 elseif 都与前面的结束花括号在同一行
- 赋值等号前后必须加空格符
- 三元运算符
true]; 之前 echo isset($arr['crmeb']) ? $arr['crmeb'] : ''; 之后 echo $arr['crmeb'] ?? '';
- define() 定义常量数组
- 命名空间优化
CRMEB PRO规范
- 所有控制器继承app\adminapi\controller\AuthController类
- 所有数据验证放在模块下的 validates 目录下
- JSON返回使用父级 AuthController类中的success 和 fail
- 错误判断抛出异常,由一个错误类统一控制输出
- 错误码和错误提示语应该统一管理,方便切换多语言
- 数据库操作使用模型类,不能使用Db::table()
- 获取表单数据使用 crmeb\services\UtilService
- 所有控制器类命令和表名对应,按照大驼峰命名规范
- 所有文件夹命名按照小写字母加下划线定义
- 所有属性名,变量名尽量遵守小驼峰命名规范
- 复杂逻辑,多状态应适当添加行内注释
adminapi
├─ config 配置文件存放
├─ controller 控制器文件存放
│├─ v1 版本号
││├─ product 产品管理
││├─ user 用户管理
││├─ order 系统订单管理
││├─ setting 系统设置维护 系统权限管理、系统菜单管理 客服管理
││├─ chat 客服管理(列表,添加,删除,编辑)
││├─ application 各个应用模块功能管理公众号、小程序、支付宝、百度小程序、今日头条小程序
││├─ system 系统更新日志 数据库管理
││├─ finance财务管理
││├─ agent 分销管理
││├─ marketing 优惠券、积分、拼团、砍价、秒杀
││├─ echarts 数据统计分析
││├─ notification消息通知管理、模版消息(列表,通知,添加,编辑)、短信
││├─ file 附件文件管理
││├─ freight 运费模版管理 物流公司
││├─ merchant 商户管理
││├─ widget 组件 小插件
││└─ cms 文章管理
│├─AuthController.php所有控制器继承类
│├─CommonApi.php 公共接口
│└─ Login.php 登陆接口
├─ lang 语言包
│└─ zh-cn.php 中文语言包
├─ validates 数据验证目录
├─ AdminApiExceptionHandle.php 错误捕获
├─ common.php 公共函数存放处
├─ event.php 事件挂载
└─ provider.php 容器
主要特性 开源无加密
源码开源无加密,有详细的代码注释,有完整系统手册
TP6框架
使用最新的 ThinkPHP 6.0框架开发
前端采用Vue CLI框架
前端使用Vue CLI框架nodejs打包,页面加载更流畅,用户体验更好
标准接口
标准接口、前后端分离,二次开发更方便
支持队列
降低流量高峰,解除耦合,高可用
长连接
减少CPU及内存使用及网络堵塞,减少请求响应时长
无缝事件机制
行为扩展更方便,方便二次开发
后台快速生成表单
后台应用form-builder 无需写页面快速增删改查
数据表格导出
PHPExcel数据导出,导出表格更加美观可视;
数据统计分析
后台使用ECharts图表统计,实现用户、产品、订单、资金等统计分析
强大的后台权限管理
后台多种角色、多重身份权限管理,权限可以控制到每一步操作
一件安装
自动检查系统环境一键安装
安装 一键安装 上传你的代码,站点入口目录设置/public
在浏览器中输入你的域名或IP(例如:www.yourdomain.com),
安装程序会自动执行安装。期间系统会提醒你输入数据库信息以完成安装,安装完成后建议删除install目录下index.php文件或将其改名。
后台访问地址:
1.域名/admin
2.域名/index.php/admin
3.域名/index.php?s=/admin
公众号和H5首页访问地址:
1.域名/
提示:正常访问是第一中模式,第一种访问不了请检测URL重写是否配置好
安装过程中请牢记您的账号密码!
重新安装
- 清除数据库
- 删除/public/install/install.lock 文件
数据库文件目录/public/install/crmeb.sql
2.修改数据库连接文件
配置文件路径/.env
APP_DEBUG = true[APP]
DEFAULT_TIMEZONE = Asia/Shanghai[DATABASE]
TYPE = mysql
HOSTNAME = 127.0.0.1 #数据库连接地址
DATABASE = test #数据库名称
USERNAME = username #数据库登录账号
PASSWORD = password #数据库登录密码
HOSTPORT = 3306 #数据库端口
CHARSET = utf8
DEBUG = true[LANG]
default_lang = zh-cn
3.修改目录权限(linux系统)777
/public
/runtime
4.后台登录:
http://域名/admin
默认账号:admin 密码:crmeb.com
定时任务 【CRMEB|CRMEB PRO 手册】在自动收货,库存预警等功能使用到
php think timer [ status ] [ --d ]
参数
- status: 状态
- start: 启动
- stop: 关闭
- restart: 重启
- --d : 后台执行
php think workerman [ status ] [ server ] [ --d ]
windows环境下需要分三步执行
# 内部通讯服务
php think workerman start channel
# h5端聊天服务
php think workerman start chat
# 后台管理员通知
php think workerman start admin
参数
- status: 状态
- start: 启动
- stop: 关闭
- restart: 重启
- server: 服务 (windows)
- channel: 内部通讯
- chat: h5
- admin: 后台
- --d : 后台执行
TP6开发手册
参与开发 请参阅 CRMEB。
版权信息 本项目包含的第三方源码和二进制文件之版权信息另行标注。
版权所有Copyright ? 2017-2019 by CRMEB (http://www.crmeb.com)
All rights reserved。
CRMEB? 商标和著作权所有者为西安众邦网络科技有限公司。
推荐阅读
- 杭电oj——2030汉字统计
- 最有效的时间管理工具(赢效率手册和总结笔记)
- 幼小衔接家长手册(欢迎来到一年级读后感)
- 设计模式-代理模式-Proxy
- Improve|Improve Nested Conditionals(优化嵌套的条件语句) 面对大量的if-else语句
- D014+6组银桥+《人生效率手册》读书笔记
- Java|Java spi(service provider interface)
- 使用Promise对微信小程序wx.request请求方法进行封装
- 日反思成功效率手册0114-2019爱诺燕儿(周1)D621
- neo4j|neo4j cql语句 快速查询手册