<?php
/**
* Adminer.class.php
* 后台管理员接口操作类
*
* @license http://www.gnu.org/licenses/old-licenses/lgpl-2.1.txt LGPL
* @copyright Copyright (c) 2014 - ? VcySDK (http://www.vchangyi.com/)
* @author zhuxun37
* @version 1.0.0
*/
namespace VcySDK;
use VcySDK\Logger;
use VcySDK\Config;
class Adminer
{
// 超级管理员标识
const SUPER_MANAGER = 15;
// 登陆用系统(超级)管理员标识
const SUPER_MANAGER_LOGIN = 1;
// 管理员没被禁用(正常)
const MANAGER_ABLE_LOGIN = 1;
// 管理员被禁用
const MANAGER_DISABLE_LOGIN = 2;
// 返回所有管理员
const FILTER_TYPE_ALL = 1;
// 返回已经补全手机号码的管理员
const FILTER_TYPE_MOBILE = 2;
/**
* 验证新密码是否在过去使用过
*/
const CHECK_OLD_PASSWORD_TRUE = 1;
const CHECK_OLD_PASSWORD_FALSE = 2;
// 管理员邀请邮件模板名
const INVITE_EMAIL_TYPE_INVITE = 'yq_invite_mail';
// 管理员已激活
const IS_ACTIVATED = 1;
/**
* 超级管理员标识
*/
const TYPE_SUPER_ADMIN = 1;
/**
* 管理级别：超级管理
*/
const ADMIN_LEVEL_SUPER = 1;
/**
* 管理级别：分级管理
*/
const ADMIN_LEVEL_BRANCH = 2;
/**
* 接口调用类
*
* @var object|Service
*/
private $serv = null;
/**
* 企业管理员新增
* %s = {apiUrl}/b/{enumber}/adminer/register
*
* @var string
*/
const REGISTER_URL = '%s/adminer/register';
/**
* 编辑企业管理员
* %s = {apiUrl}/b/{enumber}/adminer/modify
*
* @var string
*/
const MODIFY_URL = '%s/adminer/modify';
/**
* 删除企业管理员
* %s = {apiUrl}/b/{enumber}/adminer/del
*
* @var string
*/
const DEL_URL = '%s/adminer/del';
/**
* 获取企业管理员详情
* %s = {apiUrl}/b/{enumber}/adminer/detail
*
* @var string
*/
const GET_URL = '%s/adminer/detail';
/**
* 获取企业管理员列表
* %s = {apiUrl}/b/{enumber}/adminer/page-list
*
* @var string
*/
const LIST_URL = '%s/adminer/page-list';
/**
* 修改企业管理员密码
* %s = {apiUrl}/b/{enumber}/adminer/modify-pwd
*
* @var string
*/
const MODIFY_PWD_URL = '%s/adminer/modify-pwd';
/**
* 管理员登录记录
* %s = {apiUrl}/b/{enumber}/adminer/login-log
*
* @var string
*/
const LOGIN_LOG_URL = '%s/adminer/login-log';
/**
* 管理员密码验证
* %s = {apiUrl}/s/login/check-pwd
*
* @var string
*/
const CHECK_PWD_URL = '%s/login/check-pwd';
/**
* 验证手机号是否已被绑定
* %s = {apiUrl}/b/{enumber}/adminer/valid-bind-mobile
*
* @var string
*/
const VALID_BIND_MOBILE = '%s/adminer/valid-bind-mobile';
/**
* 验证手机号是否可以绑定(单点登录绑定手机号使用)
* %s = {apiUrl}/b/{enumber}/valid-mobile-can-bind
*
* @var string
*/
const VALID_CAN_BIND_MOBILE = '%s/adminer/valid-mobile-can-bind';
/**
* 管理员绑定手机号(单点登录)
* %s = {apiUrl}/b/{enumber}/adminer/bind-mobile
*
* @var string
*/
const BIND_MOBILE = '%s/adminer/bind-mobile';
/**
* 完善超级管理员信息
* %s = {apiUrl}/b/{enumber}/adminer/complete-owner-info
*
* @var string
*/
const COMPLETE_OWNER_INFO = '%s/adminer/complete-owner-info';
/**
* 根据手机号查询所属全部企业、管理员列表
* %s = {apiUrl}/b/{enumber}/adminer/enterprise-adminer-list
*
* @var string
*/
const ENTERPRISE_ADMINER_LIST = '%s/adminer/enterprise-adminer-list';
/**
* 重置管理员密码
* %s = {apiUrl}/b/{enumber}/adminer/reset-adminer-pwd
*
* @var string
*/
const RESET_ADMINER_PWD = '%s/adminer/reset-adminer-pwd';
/**
* 移交超级管理员
* %s = {apiUrl}/b/{enumber}/adminer/transfer-super-admin
*
* @var string
*/
const TRANSFER_SUPER_ADMIN = '%s/adminer/transfer-super-admin';
/**
* 获取微信登录URL
* %s = {apiUrl}/b/{enumber}/adminer/wx-login-url
*
* @var string
*/
const WECHAT_LOGIN_URL = '%s/adminer/wx-login-url';
/**
* 管理员密码验证
* %s = {apiUrl}/s/qy/login/go-wx-manager-page
*
* @var string
*/
const GOTO_WX_MANAGER_PAGE = '%s/qy/login/go-wx-manager-page';
/**
* 企业管理员,角色总数
*/
const ADMINER_AND_ROLE_TOTAL = '%s/statistics/manager';
/**
* 企业管理员,角色总数
*/
const INVITE_SEND_INVITATION = '%s/adminer/invite/send-invitation';
/**
* 企业管理员邀请-验证邀请有效性
*/
const INVITE_INVITATION_ACTIVE = '%s/adminer/invite/invitation-active';
/**
* 企业管理员邀请-设置管理员密码（初始化管理员密码）
*/
const INIT_SET_PASSWORD = '%s/adminer/set-pwd';
/**
* 根据用户 UID 换取绑定的管理员详情
*/
const ADMINER_SECURITY_DETAIL = '%s/adminer/security/detail';
/**
* 初始化
*
* @param object $serv 接口调用类
*/
public function __construct($serv)
{
$this->serv = $serv;
}
/**
* 获取微信后台登录地址
*
* @param array $data 请求参数
*
* @return string
* @throws Exception
*/
public function getWechatManagerPageUrl($data = array())
{
$url = $this->serv->generateApiUrlS(self::GOTO_WX_MANAGER_PAGE);
if (! empty($data) && is_array($data)) {
$url = $url . (false === stripos($url, '?') ? '?' : '&') . http_build_query($data);
}
return $url;
}
/**
* @param array $adminer 管理员信息
*
* @return bool|mixed
* @throws Exception
*/
public function register($adminer)
{
return $this->serv->postSDK(self::REGISTER_URL, $adminer, 'generateApiUrlE');
}
/**
* @param array $adminer 管理员信息
*
* @return bool|mixed
* @throws Exception
*/
public function modify($adminer)
{
return $this->serv->postSDK(self::MODIFY_URL, $adminer, 'generateApiUrlE');
}
/**
* 删除管理员信息
*
* @param $condition
* + string eaId 管理员ID
*
* @return bool|mixed
* @throws Exception
*/
public function del($condition)
{
return $this->serv->postSDK(self::DEL_URL, $condition, 'generateApiUrlE');
}
/**
* @param array $condition 管理员查询条件
*
* @return bool|mixed
* @throws Exception
*/
public function fetch($condition)
{
return $this->serv->postSDK(self::GET_URL, $condition, 'generateApiUrlE');
}
/**
* 获取企业管理员列表
*
* @param array $condition 查询条件数据
* @param mixed $orders 排序字段
* @param int $page 当前页码
* @param int $perpage 每页记录数
*
* @return boolean|multitype:
*/
public function listAll($condition = array(), $page = 1, $perpage = 30, $orders = array())
{
// 查询参数
$condition = $this->serv->mergeListApiParams($condition, $orders, $page, $perpage);
return $this->serv->postSDK(self::LIST_URL, $condition, 'generateApiUrlE');
}
/**
* @param array $condition 更新信息
*
* @return bool|mixed
* @throws Exception
*/
public function modifyPWD($condition)
{
return $this->serv->postSDK(self::MODIFY_PWD_URL, $condition, 'generateApiUrlE');
}
/**
* 管理员登录记录
*
* @param $condition
* + string eaId 管理员ID
* + int ealErrcode 登录错误码
* + string ealErrmsg 登录错误详情
* + string eaIp 最近一次登录IP
* + int eaLastlogin 最近一次登录时间戳
*
* @return bool|mixed
* @throws Exception
*/
public function loginLog($condition)
{
return $this->serv->postSDK(self::LOGIN_LOG_URL, $condition, 'generateApiUrlE');
}
/**
* 管理员密码验证
*
* @param $data
* + string eaMobile 登录手机号， eaMobile和eaEmail不能同时为空，eaMobile不为空时，忽略eaEmail
* + string eaEmail 登录邮箱，eaMobile和eaEmail不能同时为空,，eaMobile不为空时，忽略eaEmail
* + string eaPassword 登录密码，非明文传递，业务md5(明文)处理一次
*
* @return bool|mixed
* @throws Exception
*/
public function checkPwd($data)
{
return $this->serv->postSDK(self::CHECK_PWD_URL, $data, 'generateApiUrlS');
}
/**
* 验证手机号是否已被绑定
*
* @param $data
* + string eaMobile 需要绑定的手机号
* + string epEnumber 企业帐号，不为空时，验证所传企业当前手机号是否已被绑定(单企业唯一性)； 否则验证系统全局唯一性
*
* @return bool|mixed
* @throws Exception
*/
public function validMoblie($data)
{
return $this->serv->postSDK(self::VALID_BIND_MOBILE, $data, 'generateApiUrlS');
}
/**
* 绑定手机
*
* @param $data
* + string eaId 管理员ID
* + string eaMobile 需要绑定的手机号
* + string eaPassword 管理员登录密码， 非明文，业务平台需md5(明文)一次
*
* @return bool|mixed
* @throws Exception
*/
public function bindMobile($data)
{
return $this->serv->postSDK(self::BIND_MOBILE, $data, 'generateApiUrlE');
}
/**
* 验证手机号是否可以绑定(单点登录绑定手机号使用)
*
* @param $data
* + string eaMobile 需要绑定的手机号
*
* @return bool|mixed
* @throws Exception
*/
public function validMobileBind($data)
{
return $this->serv->postSDK(self::VALID_CAN_BIND_MOBILE, $data, 'generateApiUrlE');
}
/**
* 完善账号信息
*
* @return bool|mixed
* @throws Exception
*/
public function completeOwnerInfo($data)
{
return $this->serv->postSDK(self::COMPLETE_OWNER_INFO, $data, 'generateApiUrlE');
}
/**
* 根据手机号查询所属全部企业、管理员列表
*
* @return bool|mixed
* @throws Exception
*/
public function enterpriseAdminerList($data)
{
return $this->serv->postSDK(self::ENTERPRISE_ADMINER_LIST, $data, 'generateApiUrlS');
}
/**
* 移交超级管理员
*
* @param array $data 移交目标数据
* + transferAdminType 移交超管类型 1-选择已存在的管理员, 2-新增管理员移交
* + newSuperEaId 被移交的管理员ID, transferAdminType=1时必须
* + eaMobile 新增管理员手机号, transferAdminType=2时必须
* + eaRealname 新增管理员姓名, transferAdminType=2时必须
* + eaPassword 新增管理员密码, transferAdminType=2时必须
* + eaEmail 新增管理员邮箱
*
* @return array|bool
* @throws Exception
*/
public function transferSuperAdmin($data)
{
return $this->serv->postSDK(self::TRANSFER_SUPER_ADMIN, $data, 'generateApiUrlE');
}
/**
* 重置管理员密码
*
* @return bool|mixed
* @throws Exception
*/
public function resetAdminerPwd($data)
{
return $this->serv->postSDK(self::RESET_ADMINER_PWD, $data, 'generateApiUrlE');
}
/**
* 获取登录URL
*
* @param array $data 请求数据
*
* @return array|bool
* @throws Exception
*/
public function wechatLoginUrl($data)
{
return $this->serv->postSDK(self::WECHAT_LOGIN_URL, $data, 'generateApiUrlE');
}
/**
* 企业管理员,角色总数
* @return array|bool
* @throws Exception
*/
public function adminerAndRoleTotal()
{
return $this->serv->postSDK(self::ADMINER_AND_ROLE_TOTAL, [], 'generateApiUrlE');
}
/**
* 企业管理员-发送邀请邮件、短信接口（异步）
* @param params
* 字段名 | 是否必填 | 字段类型 | 说明
* eaId 是 String 管理员ID
* aiaToken 是 String 邀请链接token, 业务自己生成，单企业唯一
* mcTplName 是 String 邮件模板名称
* mcSubject 是 String 邮件标题
* mcVars 否 Object 邮件内容变量键值
* smsMessage 是 String 短信内容，邀请链接地址需要格式成段地址
* @return array|bool
* @throws Exception
*/
public function inviteSendInvitation($params)
{
return $this->serv->postSDK(self::INVITE_SEND_INVITATION, $params, 'generateApiUrlE');
}
/**
* 验证邀请有效性
* @param $params
* + aiaToken String 邀请token
* @return array|bool
*/
public function inviteInvitationActive($params)
{
return $this->serv->postSDK(self::INVITE_INVITATION_ACTIVE, $params, 'generateApiUrlE');
}
/**
* 设置管理员密码（初始化管理员密码）
* @param $params
* @return array|bool
*/
public function initPwd($params)
{
return $this->serv->postSDK(self::INIT_SET_PASSWORD, $params, 'generateApiUrlE');
}
/**
* 根据用户 UID 换取绑定的管理员详情
* @param $userId
* @return array|bool
* @throws Exception
*/
public function getAdminerDetailByUid($userId)
{
return $this->serv->postSDK(self::ADMINER_SECURITY_DETAIL, ['userId' => $userId], 'generateApiUrlE');
}
}