ThinkPlugsAccount

多端用户管理插件，此插件为会员尊享插件，未授权不可商用。

已支持 微信服务号 和 微信小程序 两种授权登录，之后通过手机验证码绑定主账号。另外还支持通过阿里云手机短信验证登录并自动绑定主账号，适用 H5 及 App 等环境登录。账号服务层数据已支持 微信服务号、微信小程序、安卓APP程序、苹果IOS程序、手机网页端、电脑网页端 以及 自定义方式。

话术解析

账号调度器 Account，用于创建账号管理的实例对象，以及处理部分基础数据；
账号接口类型 Account::IOSAPP，终端用户请求的通道标识，通常以字段 type 传参数；
账号实例接口 AccountInterface，包含用户账号编号、终端用户编号的数据及对应的操作，包含接口授权等操作；
用户账号编号 unid，对应数据表 PlugsUser 的 id 字段，用户的唯一账号，通过绑定与解绑来关联终端用户；
终端用户编号 usid，对应数据表 PlugsBind 的 id 字段，用户的其中一种登录账号，同时只能绑定一个用户账号；

注意： 用户账号编号 unid 是由终端用户登录后，调用 $account->bind() 创建或绑定用户账号，进而获取用户账号编号 unid 值。终端用户编号取消关联用户账号，调用 $account->unbind() 即可，随后终端用户又可以绑定其他用户账号。

加入我们

我们的代码仓库已移至 Github，而 Gitee 则仅作为国内镜像仓库，方便广大开发者获取和使用。若想提交 PR 或 ISSUE 请在 ThinkAdminDeveloper 仓库进行操作，如果在其他仓库操作或提交问题将无法处理！。

依赖插件

插件服务管理中心：ThinkPlugsCenter
多终端用户管理插件：ThinkPlugsAccount

开放接口

通过用户登录接口，换取 JWT-TOKEN 内容，之后接口需要在每次请求的头部 header 加上 Api-Token 字段并带上之后获取到的值。

详情请阅读：POSTMAN - 接口文档

标准安装

### 安装前建议尝试更新所有组件
composer update --optimize-autoloader

### 注意，插件仅支持在 ThinkAdmin v6.1 中使用
composer require zoujingli/think-plugs-account --optimize-autoloader

定制安装

复制插件 ThinkPlugsAccount 所有源代码到 plugin/think-plugs-account 目录。
修改插件 composer.json 文件追加 version 配置项，插件 ThinkPlugsAccount 的完整配置如下：

{
  "type": "think-admin-plugin",
  "name": "zoujingli/think-plugs-account",
  "version": "1.0.0",
  "homepage": "https://thinkadmin.top",
  "description": "Account Plugin for ThinkAdmin",
  "authors": [
    {
      "name": "Anyon",
      "email": "zoujingli@qq.com"
    }
  ],
  "require": {
    "php": ">7.1",
    "ext-gd": "*",
    "ext-curl": "*",
    "ext-json": "*",
    "zoujingli/think-install": "^1.0|@dev",
    "zoujingli/think-library": "^6.1|@dev"
  },
  "require-dev": {
    "phpunit/phpunit": "^7.0|*"
  },
  "autoload": {
    "psr-4": {
      "plugin\\account\\": "src"
    }
  },
  "autoload-dev": {
    "psr-4": {
      "think\\admin\\tests\\": "tests/"
    }
  },
  "extra": {
    "think": {
      "services": [
        "plugin\\account\\Service"
      ]
    },
    "plugin": {
      "copy": {
        "stc/database": "database/migrations"
      }
    },
    "config": {
      "type": "plugin",
      "name": "用户账号管理",
      "document": "https://thinkadmin.top/plugin/think-plugs-account.html",
      "license": [
        "VIP"
      ]
    }
  }
}

修改项目根 composer.json 配置，增加 ThinkPlugsAccount 插件本地化路径配置，完整配置如下：

{
  "type": "project",
  "name": "zoujingli/thinkadmin",
  "version": "1.0.0",
  "license": "MIT",
  "homepage": "https://thinkadmin.top",
  "description": "Application Development Framework",
  "keywords": [
    "ThinkAdmin",
    "ThinkLibrary",
    "WeChatDeveloper"
  ],
  "authors": [
    {
      "name": "Anyon",
      "email": "zoujingli@qq.com"
    }
  ],
  "require": {
    "php": ">7.1",
    "ext-gd": "*",
    "ext-json": "*",
    "ext-openssl": "*",
    "zoujingli/think-plugs-admin": "^1.0",
    "zoujingli/think-plugs-account": "^1.0"
  },
  "repositories": [
    {
      "type": "path",
      "url": "plugin/think-plugs-account"
    }
  ],
  "config": {
    "sort-packages": true,
    "allow-plugins": {
      "zoujingli/think-install": true
    }
  }
}

在项目根目录终端执行 composer update 完成安装。

卸载插件

### 注意，插件卸载不会删除数据表，需要手动删除
composer remove zoujingli/think-plugs-account

调用案例

// 账号管理调度器
use plugin\account\service\Account;

// @ 注册一个新用户（ 微信小程序标识字段为 openid 字段 ）
//   不传 TOKEN 的情况下并存在 openid 时会主动通过 openid 查询用户信息
//   如果传 TOKEN 的情况下且 opneid 与原 openid 不匹配会报错，用 try 捕获异常
//   注意，每次调用 Account::mk() 都会创建新的调度器，设置 set 和 get 方法的 rejwt 参数可返回接口令牌 
$account = Account::mk(Account::WXAPP, $TOKEN = '');
$user = $account->set(['openid'=>'OPENID', 'phone'=>'13888888888']);
var_dump($user);

// 列如更新用户手机号，通过上面的操作已绑定账号，可以直接设置
$account->set(['phone'=>'1399999999']);

// 设置额外的扩展数据，数据库没有字段，不需要做为查询条件的字段
$account->set(['extra'=>['desc'=>'用户描述', 'sex'=>'男']]);

// 获取用户资料，无账号返回空数组
$user = $account->get();
var_dump($user);

// 以上插件仅仅是注册终端账号，也就是临时账号
// 下面我们通过 bind 操作，绑定或创建用户账号（ 主账号 ）
$user = $account->bind(['phone'=>'1399999999'],['uesrname'=>"会员用户"]);
var_dump($user); // $user['user'] 是主账号信息

// 解除该终端账号关联主账号
$user = $account->unBind();
var_dump($user); // 此处不会再有 $user['user'] 信息

// 判断终端账号是否为空，也就是还没有调用 set 访问或 init 失败
$user = $account->isNull();

// 获取接口 Token 信息
$user = $account->get(true);
var_dump($user); // $user['token'] 即为 JwtToken 值，接口 header 传 api-token 字段

// 判断终端账号是否已经关联主账号
$is = $account->isBind();
var_dump($is);

// 获取主账号关联的所有终端账号
$binds = $account->allBind();

// 通过终端USID取消其关联主账号
$binds = $account->delBind($usid);

// 动态注册接口通道，由插件服务类或模块 sys.php 执行注册
Account::add('diy', '自定义通道名称', '终端用户编号验证字段');

// 通道状态 - 禁用接口，将禁止该方式访问数据
Account::set('diy', 0);

// 通道状态 - 启用接口，将启用该方式访问数据
Account::set('diy', 1);

// 保存通道状态，下次访问也同样生效
Account::save();

// 获取接口认证字段以及检查接口是否有效
$field = Account::field('diy');
if($field)// 接口有效
else //接口无效

// 获取全部接口
$types = Account::types();
var_dump($types);

功能节点

可根据下面的功能节点配置菜单及访问权限，按钮操作级别的节点未展示！

用户账号管理：plugin-account/master/index
终端用户管理：plugin-account/device/index

插件数据

本插件涉及数据表有：

插件-账号-授权 plugin_account_auth
插件-账号-终端 plugin_account_bind
插件-账号-资料 plugin_account_user

版权说明

ThinkPlugsAccount 为 ThinkAdmin 会员插件。

未获得此插件授权时仅供参考学习不可商用，了解商用授权请阅读《会员授权》。