Skip to content

用户余额

简介

只要在开发项目中用户需要使用余额就可以使用,比如说用户的余额、积分、金豆、抽奖次数等,可自定义余额类型

预览

查看总后台的用户余额

使用

扩展自己的余额类型

1、在plugin/balance/config/superadminx.php中设置自己的余额类型

2、修改余额表sa_balane中的字段,修改同上面的superadminx.php中设置的字段,增加、修改、减少自己的余额字段

3、新建余额明细表sa_balance_detail_xxxxx,可以将sa_balance_detail_money表复制一份,修改表名即可

TIP

完成以上步骤即可,后台的列表、明细、导出等都会自动更改为新的余额类型

程序内部使用

在程序内部用提供了两个方法:

php
// 获取用户的余额,如果新用户注册后想初始化用户的余额,也可以调此方法
$userBalance = balance_get(
    // 用户id
    $userId,
    // 可选,余额类型,否则返回所有的
    $balanceType
);

// 变更用户的余额
// 成功不返回任何值,失败会抛出错误
// 不允许修改余额为负数,如张三给李四转账,都不用先判断张三余额是否足够(因为余额不足会抛出错误),直接先调用此方法扣除张三的余额,在增加李四的余额即可
balance_change(
    // 用户id
    $userId,
    // 变更的值,正数为加,负数为减
    $changeValue,
    // 变更的余额类型,如 money
    $balanceType,
     // 变更的明细类型
    $detailsType,
    // 标题,变更的原因
    $title,
    // 是否允许余额变更为负数
    $isNegative 
);

前端api接口

查看接口文档