用thinkphp插件管理用户积分体系【运营妙招】

在运营一个积分体系时，最头疼的是什么？不是规则复杂，而是每次调整都得去改核心代码、写SQL，生怕一不小心把系统搞崩了。其实，ThinkPHP框架里已经有现成的插件方案，可以帮运营人员快速配置积分的获取与消耗规则——比如签到送分、购物返分、兑换礼品扣分，而且完全不需要碰底层逻辑。来说几个关键点。

安装并启用积分插件

首先，在项目根目录下执行一行命令，安装官方维护的think-integral插件包：

composer require topthink/think-integral

安装完成后，打开app/config/app.php，在'middleware'数组末尾追加IntegralMiddleware::class。如果这个中间件不存在，很可能是插件配置还没有发布——务必注意：没有执行php think integral:install这一步，后续所有积分操作都不会有反应。

配置基础积分参数

执行命令生成配置文件：

php think integral:publish

然后编辑config/integral.php，重点修改下面三项：

'default_rule' => 'user_level'：表示新用户注册后，默认按会员等级匹配积分规则。如果设成'none'，新用户积分就一直是0，且不会自动增长。

把'exchange_rate' => 100改成50，意味着1元=50积分——这在商城类项目里很常见。

设置'max_daily_gain' => 200，作用是限制单日最高获取积分，防止羊毛党通过刷签到一天狂揽上千分。

定义积分行为规则

有两种方式：

方式一：后台可视化配置（推荐运营人员使用）

登录后台管理页，找到「积分中心」→「行为规则」→「新增规则」。填写「行为标识」，比如order_pay，「触发条件」选择「订单支付成功」，「奖励积分」填{amount}*10（这里支持字段变量解析，非常灵活）。

方式二：代码注册（适合开发阶段预埋）

在app/event/IntegralEvent.php中，于bind()方法里添加：

IntegralRule::register('login_daily', ['gain' => 20, 'limit' => 1, 'desc' => '每日首次登录']);

这里要特别提醒：行为标识login_daily必须全局唯一，如果重复注册，新规则会覆盖旧的，而且不会给出任何报错提示。

触发积分变动

第一步：在业务逻辑中获取用户积分实例

$integral = thinkfacadeIntegral::user($userId);

第二步：执行增加操作（比如用户完成支付后）

$integral->gain('order_pay', ['amount' => $order['pay_price']], '订单返积分');

第三步：执行扣除操作（比如兑换优惠券）

$integral->deduct('coupon_use', ['coupon_id' => $id], '兑换满减券');

每一步都必须传入行为标识和描述信息，否则日志无法追溯。另外，如果扣除积分时余额不足，系统会默认拒绝执行，并抛出IntegralException异常——也就是说，不会出现透支情况。