DavidNineRoc/monday-shop

TODO

再来一单
查看物流
数据分析
API 接口开发,具体看文目录 API

目录说明

演示地址
页面展示
特色
安装
命令行功能
秒杀处理逻辑
API文档(新)
依赖的 Packages
文章引用
错误/注意点
协议

演示地址

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

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

账号：admin
密码：admin

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

页面展示

Feature

Installation

获取源代码

直接下载压缩包或者monday-shop.zip下载
或者git克隆源代码

git clone git@github.com:DavidNineRoc/monday-shop.git

安装依赖扩展包

composer install

生成配置文件(修改其中的配置选项:数据库的一定要修改)

cp .env.example .env

开启秒杀功能
- 安装前可以把database/seeds/SettingsTablesSeeder.php中的秒杀开启设置为1
- 安装之后可以直接通过后台管理系统设置中的配置设置管理
使用安装命令(会执行执行数据库迁移，填充，等)

php artisan moon:install

任务调度(订阅推荐，数据统计！！！)
- windows
  - windows下使用laravel任务调度
- Linux
  - * * * * * php /你的项目根目录/artisan schedule:run >> /dev/null 2>&1
  - linux 详情请去看官网
运行队列处理器(发送订阅邮件，自动取消订单)
- Linux系统:
  - nohup php artisan queue:work --tries=3 &
- windows系统直接打开一个命令行窗口，运行命令，不要关闭窗口即可
  - php artisan queue:work --tries=3

Commands

命令	一句话描述
`php artisan moon:install`	安装应用程序
`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)

Name		Name	Last commit message	Last commit date
Latest commit History 543 Commits
app		app
bootstrap		bootstrap
config		config
database		database
public		public
resources		resources
routes		routes
storage		storage
tests		tests
.env.example		.env.example
.gitattributes		.gitattributes
.gitignore		.gitignore
artisan		artisan
composer.json		composer.json
composer.lock		composer.lock
package.json		package.json
phpunit.xml		phpunit.xml
readme.md		readme.md
server.php		server.php
webpack.mix.js		webpack.mix.js

Baiyuetribe/monday-shop

Folders and files

Latest commit

History

Repository files navigation

DavidNineRoc/monday-shop

TODO

目录说明

演示地址

页面展示

Feature

Installation

Commands

秒杀处理逻辑

API

Packages

Reference

Notice

License

About

Resources

Stars

Watchers

Forks

Languages