系统

定义

操作

# 项目初始化
$ php artisan py-system:install

# 用户部分
$ php artisan py-system:user {slug}

用户

本系统基于角色的权限访问控制（Role-Based Access Control）

用户类型

根据使用分为三种用户类型(默认)

user            # 前台用户
develop         # 开发者用户
backend         # 后台用户

对于用户的类型区分我们使用 Header 来进行区分, Header 的名称是 x-type 来进行区分, 区分的层级为

1. 中间件参数 [web, backend, develop, jwt, jwt_backend, jwt_web, jwt_develop]
2. Header参数 [user/backend/develop]

参数的类型便是用户的类型, 这里的数据和 guard起到映射关系, 但无需一致

根据使用到的用户的类型我们应当分为这几项

Guard : web,backend,develop Type : user, backend, develop

用户 - api (jwt) 驱动
用户 - web 驱动
开发 - web 驱动
后端 - web 驱动
后端 - api (jwt) 驱动

每一种用户定义的角色分为三种

root     : 后台超级管理员
user     : 前台普通用户
develop  : 开发者

密码加密方式

$password     : 原始密码
$reg_datetime : 注册时间(datetime) 类型
$randomKey    : 六位随机值
md5(sha1($password . $reg_datetime) . $randomKey);

通行证约定

标题	类型	备注
id	int(10)
username	varchar(45)	字母数字下划线中文, 冒号(英文,子用户使用)
mobile	varchar(45)	手机号, 格式 86-15555555555, 国别手机号
email	varchar(50)	邮箱

因为以上这些可以作为通行证, 所以必须是经过认证的才可以写入这个数据表, 否则无法进行写入

平台

平台遵循标准化, x-id: 定义为设备ID

配置

本模块的配置是注入到 poppy.php 文件中, 以下的所有配置均可配置 key 是 poppy.system

cross_origin

• Type : string|array
• Default : ''

接口请求的时候可以对来源进行设定, 防止 web 端跨域访问资源, 这里的来源可以为 * 或者数组, 数组为类似于 http://poppy.wulicode.com 这种形式, 如果是网址则只能填写一个完整字串, 或者多个网址, 使用 数组进行设定

'cross_origin'      => [
    'http://poppy.wulicode.com'
],

cross_headers

• Type : string
• Default : ''

允许的 Header, 可以允许设定前端访问的时候指定的 Header 可以通过浏览器跨域验证, 多个参数使用 , 分隔

cross_headers => 'X-APP-VERSION'

demo

• Type : bool
• Default : false

演示模式, 开启则无法上传文件, 修改密码

upload_image_district

• Type : array
• Default : ['default' => 1920,'avatar' => 300,]

上传图片大小限制, 根据接口上传的 image_type 类型对图片进行压缩

'upload_image_district' => [
    'default' => 1920,
    'avatar'  => 300,
    ...
],

csrf_except

• Type : array
• Default : []

支持 Laravel 的路由过滤的方式来移除匹配的路由不进行 csrf 验证. 参考 : CSRF 保护

uncrypt_cookies

• Type : array
• Default : []

使用 laravel cookie 进行设定时, 设定的 cookie 不进行加密输出, 方便 js 进行读取, 共享数据

password_provider

• Type : string
• Default : ''

密码加载器, 这里这里设定密码算法, 为了保护用户数据安全, 特设定此方式来保护密码计算 默认是 \Poppy\System\Classes\Auth\Password\DefaultPasswordProvider::class 替换该实现方式需要实现 \Poppy\System\Classes\Contracts\PasswordContract::class 约定.

user_location

• Type : string
• Default : ''

登录跳转地址, 使用默认的 web-auth guard 做验证则需要设定此配置, 当验证失败, 自动跳转到此路径, 这里是路径, 不是路由地址

route_hide

• Type : array
• Default : []

隐藏路由, 后台可以隐藏的路由, 写在这里, 后台列表不予显示

prefix

• Type : string
• Default : mgr-page

后台默认登陆入口

api_enable_sign

• Type : bool
• Default : true

是否启用 api 签名验证

api_sign_provider

接口签名算法, 需要实现 \Poppy\System\Classes\Contracts\ApiSignContract:class 约定

(*)payment_types

• Type : array
• Default : []

[待定]支付类型

使用 Progress 方式数据表更新

访问地址

http://xxx.com/mgr-page/develop
点击 数据表更新
参数
[
  'method' => '模型名.类名',// 类名多个单词通过 '_' 拼接
];

类的编写

在每个模块下 progress 文件夹下(没有新建)编写

# 类命名规范 数据表名+改动(自定义)+progress
class OrderHunterResultProgress implements Progress
{
  use FixTrait;

  /**
   * @return array fix
   */
  public function handle(): array
  {
    // 初始化 fix
    $this->fixInit();
    // 指定每次更新的条数
    $this->fix['section'] = 100;
    // 重新清理掉缓存
    if (!$this->fix['cached']) {
      $this->fix['cached'] = 1;
    }

    $Db = OrderHunter::where('first_result', '!=', '');

    if (!$this->fix['total']) {
      $this->fix['total'] = $Db->count();
    }
    if (!$this->fix['max']) {
      $this->fix['max'] = $Db->max('id');
    }
    if (!$this->fix['min']) {
      $this->fix['min'] = $Db->min('id');
    }

    // ↑↑↑↑↑↑↑↑↑↑↑   获取参数

    // 剩余数
    $this->fix['left'] = $Db->whereRaw('id > ?', [$this->fix['start']])
      ->count('id');

    $this->fix['lastId'] = $this->fix['start'];

    if ($this->fix['left']) {
      // 业务逻辑
      $left_items = OrderHunter::whereRaw('id >= ?', [$this->fix['start']])
        ->where('first_result', '!=', '')
        ->take($this->fix['section'])
        ->orderBy('id', 'asc')
        ->get(['id']);
      foreach ($left_items as $item) {
        self::normal($item->id);
        $this->fix['lastId'] = $item->id + 1;
      }
    }

    return $this->fix;
  }
}

中间件

JwtAuthenticate

作用

• 校验 token 是否合法(不涉及到数据库查询, 校验 Token 合法性)
• 校验 用户密码是否符合, 在拿到授权之后, 对比 salt, 验证是否合法

流程参考

Ban

对用户进行IP/设备的封禁

如果是前台用户, 放到所有请求之前 如果是后台用户, 放到所有请求之后(需要放过管理员)