seth-shi/monday-shop

!!! 非Docker运行请使用v1https://github.com/seth-shi/monday-shop/tree/1.0

QQ 群

584453488

部署(新新新)

下载源码(也可直接下载压缩包, 然后解压)
- git clone https://github.com/seth-shi/monday-shop.git
修改配置
- cp .env.example .env
- 修改.env文件中数据库,域名等配置信息
构建镜像
- docker build . -t monday-shop
运行
- -p 80:5200, 80代表本机的端口,5200写死是swoole服务运行的端口
- docker run -d -p 80:5200 --name monday-shop-service monday-shop
执行命令迁移
- docker exec monday-shop-service php artisan migrate

演示地址

演示地址：http://shop.shiguopeng.cn

后台地址：http://shop.shiguopeng.cn/admin

账号：admin
密码：admin

测试支付功能
- 下载支付宝沙箱
- 账号：eyxweq5099@sandbox.com
- 密码：111111
- 支付密码：111111
- 当前账户余额：9999999.99
- 余额不足，请联系我及时充值

页面展示

Feature

Commands

命令	一句话描述
`php artisan moon:install`	安装应用程序
`php artisan add:shop-to-search`	生成全文索引
`php artisan moon:uninstall`	卸载网站(清空数据库，缓存，路由)
`php artisan moon:cache`	执行缓存（缓存配置，路由，类映射）
`php artisan moon:clear`	清除缓存
`php artisan moon:copy`	复制项目内置的静态资源
`php artisan moon:delete`	删除项目及上传的基本静态资源
`php artisan moon:export`	导出用户数据到json文件
`php artisan moon:count-site`	统计站点任务（每天夜里一点执行）
`php artisan moon:del-seckills`	删除秒杀数据 (每小时自动执行一次)
`php artisan moon:moon:del-score-data`	删除积分缓存数据 (每天夜里 0 点执行)
`php artisan moon:update-home`	更新首页数据 (每分钟自动执行一次)
`php artisan moon:send-subscribes`	发送订阅邮件 (每个礼拜六早上八点)
`php artisan queue:work --tries=3`	监听队列(邮件发送，处理过期的秒杀数据 !!!

秒杀处理逻辑

## 初始化抢购数据
<?php

// 假设当前秒杀活动的 id 为 9
// 可以在模型的 created 事件做这个事情
$id = 9;

// 填充一个 redis 队列，数量为抢购的数量，后面的 9 无意义
\Redis::lpush("seckills:{$id}:queue", array_fill(0, $seckill->number, 9));

?>

## 抢购
<?php

// 从路由或者参数中得到当前秒杀活动的 id
$id = 9;
$userId = auth()->id();

// 判断是否已经开始了秒杀

// 返回 0，代表当前用户已经抢购过了
if (0 == Redis::hset("seckills:{$id}:users:{$userId}", 'id', $userId)) {

    return responseJson(403, '你已经抢购过了');
}

// 如果从队列中读取到了 null，代表已经没有库存
if (is_null(Redis::lpop("seckills:{$id}:queue"))) {

    return responseJson(403, '已经抢购完了');
}

// 这里就可以开始入库订单

?>

## 利用 crontab 定时扫描过期数据，回滚库存，删除过期 redis (可选)
<?php

 // 查出已经过期确没有回滚过的秒杀，
Seckill::query()
       ->where('end_at', '<', date('Y-m-d H:i:s'))
       ->get()
       ->map(function (Seckill $seckill) {
           
           // 先模糊查找到所有用户 key
           $ids = Redis::keys("seckills:{$seckill->id}:*");
           Redis::del($ids);
           
           // 回滚库存
           // 做更多的事
       };
       
?>

API

接口响应数据说明
- 响应的数据格式总是保证拥有基本元素(code, msg, data)
- code 请参考接口全局状态码说明
- msg 此次请求消息,如果返回状态码为非成功,可直接展示msg
- data 如果为列表页将会一个数组类型(如商品列表),否则为一个对象类型(商品详情)
- 如有额外扩展字段, 将于基本元素平级, 如分页的count

{
	"code": 401,
	"msg": "无效的token",
	"data": []
}

刷新token说明
- 为了保证安全性,token的有效时间为60分钟
- 当旧的token失效时,服务器会主动刷新,并在响应头加入Authorization
- 这时候旧的token将会加入黑名单不能再使用, 请将在响应头中新的token保存使用
- 当服务器主动刷新之后,会有一个期限(2周).服务器将无法再刷新,将返回402状态码,请重新登录账户
token使用流程说明

// 全局请求类
function request(_method, _url, _param, _func) {

    $.ajax({
        method: _method,
        url: _url,
        data: _param,
        beforeSend: function (xhr) {
            console.log(xhr);
            xhr.setRequestHeader('Authorization', localStorage.getItem('api_token'))
        },
        complete: function (xhr, a, b) {

            if (xhr.getResponseHeader('Authorization')) {
                localStorage.setItem('api_token', xhr.getResponseHeader('Authorization'))
            }
        },
        success: function (res) {

            // token 永久过期
            if (res.code === 402) {
                // 跳去登录页面
                return false;
            }
            // 更多状态码判断
        }
    });
}

// 第一次登录保存 token, 之后使用全局类请求数据即可

接口全局状态码说明(建议封装一个全局请求类或者中间件,统一处理全局状态码)
- 200
  - 请求数据成功
- 401
  - 身份验证出错(未登录就请求数据)
  - 非法无效的token
  - token已被加入黑名单(一般不会出现这个问题,出现这个问题那么就是你刷新 token 的逻辑有问题)
- 402
  - token已完全失效,后台暂设为 2 周,再也无法刷新,请重新登录账户
- 500
  - 服务器出错,具体请参考响应的消息
接口文档(重要的事情说三遍)

接口文档

Packages

扩展包	一句话描述	在本项目中的使用案例
z-song/laravel-admin	后台	快速搭建后台系统
mews/captcha	验证码	登录注册功能使用验证码验证
overtrue/laravel-socialite	第三方登录	用户登录可以使用Github,QQ,新浪微博
intervention/image	图片处理	是为 Laravel 定制的图片处理工具，加水印
webpatser/laravel-uuid	uuid生成	商品添加增加一个uuid，订单号
renatomarinho/laravel-page-speed	压缩页面DOM	打包优化您的网站自动导致35％以上的优化（已移除使用）
overtrue/laravel-pinyin	汉语拼音翻译	分类首字母查询
acelaya/doctrine-enum-type	枚举	优化代码中的映射

Reference

Notice

建议开启bcmath扩展保证字符串数字运算正确
监听队列如果长时间没反应，或者一直重复任务
- 数据库没配置好，导致队列任务表连接不上
- 邮件配置出错，导致发送邮件一直失败
composer install安装不上依赖
- 请删除composer.lock文件，重新运行composer install
SQLSTATE[HY000]: General error: 1215 Cannot add foreign key constraint
- 数据库引擎切换到InnoDB
composer install 安装依赖错误
- composer.lock锁定了镜像源,删除composer.lock再执行即可

License

The MIT License (MIT)

pooy/monday-shop

seth-shi/monday-shop

QQ 群

部署(新新新)

目录说明

演示地址

页面展示

Feature

Commands

秒杀处理逻辑

API

Packages

Reference

Notice

License