README

这是一个基于Yii2的通用抽奖框架，连接不同的组件以支持抽奖

安装

php composer.phar require  jinhongtl/yii2-lottery

使用

配置抽奖组件
创建一个类实现lottery\LotteryInterface接口
配置抽奖算法(有默认抽奖算法，可省略)

配置

'components' => [
    'lottery' => [
        'class' => 'lottery\Lottery',
        'lotteryClass' => 'micro\controllers\RushLottery',
    ],
]

抽奖接口

<?php

namespace micro\controllers;

use lottery\LotteryInterface;
use lottery\Prize;
use Yii;

class RushLottery implements LotteryInterface
{
    /** 进入抽奖前的条件校验*/
    public static function check($userId, $activityId): bool
    {
        return true;
    }

    /** 是否允许中奖，包括总抽奖概率与用户中奖次数限制的校验 */
    public static function checkLimit($userId, $activityId): bool
    {
        return true;
    }

    /** 获取满足抽奖条件的奖品 */
    public static function getPrizes($userId, $activityId): array
    {
        $prizesDb = [
            [
                'id' => 1,
                'name' => '红包1元',
                'chance' => 50
            ],
            [
                'id' => 2,
                'name' => '耳机1个',
                'chance' => 50,
            ],
        ];
        $prizes = [];
        foreach ($prizesDb as $prize) {
            $prizes[] = Yii::createObject([
                'class' => Prize::class,
                'id' => $prize['id'],
                'name' => $prize['name'],
                'chance' => $prize['chance'],
            ]);
        }
        return $prizes;
    }

    /** 扣除抽奖机会 */
    public static function deductionLotteryNum($userId, $activityId): bool
    {
        return true;
    }

    /** 预抽奖逻辑 */
    public static function preLottery($userId, $activityId): bool
    {
        return true;
    }

    /** 如写入奖品 */
    public static function afterLottery($userId, $activityId, Prize $prize)
    {

    }
}

自定义抽奖算法

'components' => [
    'lottery' => [
        'class' => 'lottery\Lottery',
        'lotteryClass' => 'micro\controllers\RushLottery',
        'algorithm' => ''
    ],
]

jinhongtl / yii2-lottery

Maintainers

Details

README

安装

使用

配置

抽奖接口

自定义抽奖算法