系统类 · CRMEB 单商户v2 帮助文档（PHP）

## 系统类说明 * \service\CacheService 系统缓存类 ``` // 设置系统缓存 set($key, $value) // 获取系统缓存 get($key, $default) // 删除指定系统缓存 rm($key) // 清空所有系统缓存 clear() ``` * \service\ExportService 导出csv表格类 ``` // 导出Csv exportCsv($list 数据, $fliename 文件名, $header 表格头部, $br 换行分隔符) ``` * \service\GroupDataService 组合数据类 ``` // 获得组合数据信息+组合数据列表 getGroupData($configName,$limit) // 获得组合数据列表 getData($configName,$limit) ``` * \service\HookService 行为扩展类 ``` // 资源监听自动注册前置行为操作 + 行为操作 resultListen($tag, $params, $extra = null, $once = false,$behavior = null 自动注册类) // 监听后置行为操作 afterListen($tag, $params, $extra = null, $once = false, $behavior = null 自动注册类) // 监听前置行为操作 beforeListen($tag,$params,$extra = null, $once = false, $behavior = null) // 监听行为操作 listen($tag, $params, $extra = null, $once = false, $behavior = null) // 添加前置行为 addBefore($tag, $behavior, $first = false) // 添加后置行为 addAfter($tag, $behavior, $first = false) // 添加行为 add($tag, $behavior, $first = false) ``` * \service\HttpService Request请求类 ``` // 发送get请求 getRequest($url, $data = array(), $header = false, $timeout = 10) // 发送post请求 postRequest($url, $data = array(), $header = false, $timeout = 10) // 发送请求 request($url, $method = 'get', $data = array(), $header = false, $timeout = 15) // 获取请求head头 getHeaderStr():String // 获取请求head头 getHeader():Array ``` * \service\JsonService Json输出类 ``` // 成功 successful($msg = 'ok',$data=[]) // 成功+状态 status($status,$msg,$result = []) // 失败 fail($msg,$data=[]) ``` * \service\QrcodeService 二维码生成类 ``` // 获取一个临时二维码,不存在自动生成 getTemporaryQrcode($type,$id) // 获取一个永久二维码,不存在自动生成 getForeverQrcode($type,$id) // 查询已有的二维码 getQrcode($id,$type = 'id') ``` * \service\SystemConfigService 系统配置类 ``` // 获取一个系统配置,带缓存 config($key) // 获取一个系统配置,不带缓存 get($key) // 获取多个系统配置,不带缓存 more($keys = []) // 获取所有系统配置,不带缓存 getAll() ``` * \service\UploadService 文件上传类 ``` // 单图上传 image($fileName, $path, $moveName = true, $autoValidate=true, $root=null, $rule='uniqid') // 文件上传 file($fileName, $path, $moveName = true, $autoValidate=[], $root=null, $rule='uniqid') // 图片压缩 thumb($filePath, $ratio=8, $pre='s_') ``` * \service\WechatService 微信服务类参考:https://www.easywechat.com/docs/3.x ``` // 获取微信配置参数 options() // 多客服消息转发 transfer($account = '') // 上传永久素材接口 materialService() // 上传临时素材接口 materialTemporaryService() // 用户接口 userService() // 客服消息接口 staffService() // 微信公众号菜单接口 menuService() // 微信二维码生成接口 qrcodeService() // 短链接生成接口 urlService() // 用户授权 oauthService() // 模板消息接口 noticeService() // 发送模板消息 sendTemplate($openid,$templateId,array $data,$url = null,$defaultColor = null) // 支付接口 paymentService() // 下载商户流水 downloadBill($day,$type = 'ALL') // 用户标签服务 userTagService() // 用户分组服务 userGroupService() // 获得jsSdk支付参数 jsPay($openid, $out_trade_no, $total_fee, $attach, $body, $detail='', $trade_type='JSAPI', $options = []) // 订单退款 payOrderRefund($orderNo, array $opt) // 支付成功回调 handleNotify() // jssdk Config参数 jsSdk($url = '') // 回复文本消息 textMessage($content) // 回复图片消息 imageMessage($media_id) // 回复视频消息 videoMessage($media_id, $title = '', $description = '...', $thumb_media_id = null) // 回复声音消息 voiceMessage($media_id) // 回复图文消息 newsMessage($title, $description = '...', $url = '', $image = '') // 回复文章消息 articleMessage($title, $thumb_media_id, $source_url, $content = '', $author = '', $digest = '', $show_cover_pic = 0, $need_open_comment = 0, $only_fans_can_comment = 1) // 回复素材消息 materialMessage($type, $media_id) // 作为客服消息发送 staffTo($to, $message) // 获得用户信息 getUserInfo($openid) ``` * \service\WechatTemplateService 微信模板消息类 ``` // 发送模板消息 sendTemplate($openid,$templateId,array $data,$url = null,$defaultColor = '') // 给管理员发送模板消息 sendAdminNoticeTemplate(array $data,$url = null,$defaultColor = '') ``` ## 基础继承类 * \basic\ModelBasic Model基础类 ``` /** * 获得Db并缓存 * @param $name * @param bool $update * @return mixed|\think\db\Query */ protected static function getDb($name, $update = false) /** * 设置错误信息 * @param string $errorMsg * @return bool */ protected static function setErrorInfo($errorMsg = self::DEFAULT_ERROR_MSG,$rollback = false) /** * 获取错误信息 * @param string $defaultMsg * @return string */ public static function getErrorInfo($defaultMsg = self::DEFAULT_ERROR_MSG) /** * 开启事务 */ public static function beginTrans() /** * 提交事务 */ public static function commitTrans() /** * 关闭事务 */ public static function rollbackTrans() /** * 根据结果提交或者滚回事务 * @param $res */ public static function checkTrans($res) ``` * \basic\SystemBasic 后台基础类 ``` /** * 操作失败提示框 * @param string $msg 提示信息 * @param string $backUrl 跳转地址 * @param string $title 标题 * @param int $duration 持续时间 * @return mixed */ protected function failedNotice($msg = '操作失败', $backUrl = 0, $info = '', $duration = 3) /** * 失败提示一直持续 * @param $msg * @param int $backUrl * @param string $title * @return mixed */ protected function failedNoticeLast($msg = '操作失败', $backUrl = 0, $info = '') /** * 操作成功提示框 * @param string $msg 提示信息 * @param string $backUrl 跳转地址 * @param string $title 标题 * @param int $duration 持续时间 * @return mixed */ protected function successfulNotice($msg = '操作成功',$backUrl = 0,$info = '',$duration = 3) /** * 成功提示一直持续 * @param $msg * @param int $backUrl * @param string $title * @return mixed */ protected function successfulNoticeLast($msg = '操作成功',$backUrl = 0,$info = '') /** * 错误提醒页面 * @param string $msg * @param int $url */ protected function failed($msg = '哎呀…亲…您访问的页面出现错误', $url = 0) /** * 成功提醒页面 * @param string $msg * @param int $url */ protected function successful($msg, $url = 0) ``` * \basic\WapBasic Wap端基础类 ``` /** * 操作失败弹窗提示 ajax请求时返回json数据 * @param string $msg * @param int $url * @param string $title */ protected function failed($msg = '操作失败', $url = 0, $title='错误提示') /** * 操作成功弹窗提示 ajax请求时返回json数据 * @param $msg * @param int $url */ protected function successful($msg = '操作成功', $url = 0, $title='成功提醒') /** * 微信用户自动登陆并返回openid * @return string $openid */ protected function oauth() ``` ## 公共特性类 * \traits\ModelTrait Model公共特性 ``` /** * 添加一条数据 * @param $data * @return object $model 数据对象 */ public static function set($data) /** * 添加多条数据 * @param $group * @param bool $replace * @return mixed */ public static function setAll($group, $replace = false) /** * 修改一条数据 * @param $data * @param $id * @param $field * @return bool $type 返回成功失败 */ public static function edit($data,$id,$field = null) /** * 查询一条数据是否存在 * @param $map * @param string $field * @return bool 是否存在 */ public static function be($map, $field = '') /** * 删除一条数据 * @param $id * @return bool $type 返回成功失败 */ public static function del($id) /** * 分页 * @param null $model 模型 * @param null $eachFn 处理结果函数 * @param array $params 分页参数 * @param int $limit 分页数 * @return array */ public static function page($model = null, $eachFn = null, $params = [], $limit = 20) /** * 高精度加法 * @param int|string $uid id * @param string $decField 相加的字段 * @param float|int $dec 加的值 * @param string $keyField id的字段 * @param int $acc 精度 * @return bool */ public static function bcInc($key, $incField, $inc, $keyField = null, $acc=2) /** * 高精度减法 * @param int|string $uid id * @param string $decField 相减的字段 * @param float|int $dec 减的值 * @param string $keyField id的字段 * @param bool $minus 是否可以为负数 * @param int $acc 精度 * @return bool */ public static function bcDec($key, $decField, $dec, $keyField = null, $minus = false, $acc=2) ```