3
This commit is contained in:
@@ -0,0 +1,79 @@
|
||||
<?php
|
||||
|
||||
namespace support\OpenImSdk\Api;
|
||||
|
||||
use support\OpenImSdk\Core\Url;
|
||||
use support\OpenImSdk\Core\Utils;
|
||||
use support\OpenImSdk\Core\Config;
|
||||
|
||||
class Auth
|
||||
{
|
||||
/**
|
||||
* 获取管理员token
|
||||
* 直接从服务器获取,不使用缓存
|
||||
* @param string $userID 管理员ID,默认为imAdmin
|
||||
* @return array
|
||||
*/
|
||||
public function getAdminToken(string $userID = 'imAdmin'): array
|
||||
{
|
||||
$data = [
|
||||
'userID' => $userID,
|
||||
'secret' => Config::getSecret()
|
||||
];
|
||||
return Utils::send(Url::$getAdminToken, $data, '获取管理员token错误');
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取用户token
|
||||
* 直接从服务器获取,不使用缓存
|
||||
* @param string $userID 用户ID
|
||||
* @param int $platformID 平台ID,默认为1
|
||||
* @return array
|
||||
*/
|
||||
public function getUserToken(string $userID, int $platformID = 1): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
return Utils::send(Url::$getUserToken, ['userID' => $userID, 'platformID' => $platformID], '获取用户token错误', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 强制登出
|
||||
* @param string $userID 要登出的用户ID
|
||||
* @param int $platformID 平台ID,默认为1
|
||||
* @return array
|
||||
*/
|
||||
public function forceLogout(string $userID, int $platformID = 1): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
|
||||
// 清除本地缓存的用户token
|
||||
Utils::clearToken($userID);
|
||||
|
||||
return Utils::send(Url::$forceLogout, ['userID' => $userID, 'platformID' => $platformID], '强制登出错误', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 解析当前用户token
|
||||
* @param string $token 用户token
|
||||
* @return array
|
||||
*/
|
||||
public function parseToken(string $token): array
|
||||
{
|
||||
return Utils::send(Url::$parseToken, [], '解析当前用户token错误', $token);
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* 用户登录 (旧版,建议使用getUserToken)
|
||||
* @param string $userID 用户ID
|
||||
* @return array
|
||||
*/
|
||||
public function userToken(string $userID): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
return Utils::send(Url::$userToken, ['userID' => $userID], '用户登录错误', $adminToken);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,77 @@
|
||||
<?php
|
||||
|
||||
namespace support\OpenImSdk\Api;
|
||||
|
||||
use support\OpenImSdk\Core\Url;
|
||||
use support\OpenImSdk\Core\Utils;
|
||||
|
||||
class Conversation
|
||||
{
|
||||
/**
|
||||
* 获取当前用户分页会话列表
|
||||
* @param string $userID 用户ID
|
||||
* @param int $pageNumber 页码,从1开始
|
||||
* @param int $showNumber 每页数量
|
||||
* @return array
|
||||
*/
|
||||
public function getOwnerConversation(string $userID, int $pageNumber = 1, int $showNumber = 20): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'userID' => $userID,
|
||||
'pagination' => [
|
||||
'pageNumber' => $pageNumber,
|
||||
'showNumber' => $showNumber
|
||||
]
|
||||
];
|
||||
return Utils::send(Url::$getOwnerConversation, $data, '获取当前用户分页会话列表失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取排序的会话列表
|
||||
* @param string $userID 用户ID
|
||||
* @return array
|
||||
*/
|
||||
public function getSortedConversationList(string $userID): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
return Utils::send(Url::$getSortedConversationList, ['userID' => $userID], '获取排序的会话列表失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 为多个用户设置相同会话ID的字段
|
||||
* @param string $conversationID 会话ID
|
||||
* @param array $userIDs 用户ID列表
|
||||
* @param int $recvMsgOpt 接收消息选项
|
||||
* @param bool $isPinned 是否置顶
|
||||
* @param bool $isPrivateChat 是否私聊
|
||||
* @param int $groupAtType 群@类型
|
||||
* @param string $ex 扩展字段
|
||||
* @param bool $isMsgDestruct 是否开启消息销毁
|
||||
* @param int $msgDestructTime 消息销毁时间
|
||||
* @param int $burnDuration 阅后即焚时长
|
||||
* @return array
|
||||
*/
|
||||
public function setConversations(string $conversationID, array $userIDs, int $recvMsgOpt = 0, bool $isPinned = false, bool $isPrivateChat = false, int $groupAtType = 0, string $ex = '', bool $isMsgDestruct = false, int $msgDestructTime = 0, int $burnDuration = 0): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'conversationID' => $conversationID,
|
||||
'userIDs' => $userIDs,
|
||||
'conversation' => [
|
||||
'recvMsgOpt' => $recvMsgOpt,
|
||||
'isPinned' => $isPinned,
|
||||
'isPrivateChat' => $isPrivateChat,
|
||||
'groupAtType' => $groupAtType,
|
||||
'ex' => $ex,
|
||||
'isMsgDestruct' => $isMsgDestruct,
|
||||
'msgDestructTime' => $msgDestructTime,
|
||||
'burnDuration' => $burnDuration
|
||||
]
|
||||
];
|
||||
return Utils::send(Url::$setConversations, $data, '为多个用户设置相同会话ID的字段失败', $adminToken);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,212 @@
|
||||
<?php
|
||||
|
||||
namespace support\OpenImSdk\Api;
|
||||
|
||||
use support\OpenImSdk\Core\Url;
|
||||
use support\OpenImSdk\Core\Utils;
|
||||
|
||||
class Friend
|
||||
{
|
||||
/**
|
||||
* 添加黑名单
|
||||
* @param string $ownerUserID 用户ID
|
||||
* @param string $blackUserID 被拉黑用户ID
|
||||
* @return array
|
||||
*/
|
||||
public function addBlack(string $ownerUserID, string $blackUserID): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = ['ownerUserID' => $ownerUserID, 'blackUserID' => $blackUserID];
|
||||
return Utils::send(Url::$addBlack, $data, '添加黑名单错误', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 添加好友
|
||||
* @param string $fromUserID 发送者ID
|
||||
* @param string $toUserID 接收者ID
|
||||
* @param string $reqMsg 请求消息
|
||||
* @return array
|
||||
*/
|
||||
public function addFriend(string $fromUserID, string $toUserID, string $reqMsg): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = ['fromUserID' => $fromUserID, 'toUserID' => $toUserID, 'reqMsg' => $reqMsg];
|
||||
return Utils::send(Url::$addFriend, $data, '添加好友错误', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 同意/拒绝好友请求
|
||||
* @param string $ownerUserID 处理者ID
|
||||
* @param string $friendUserID 好友ID
|
||||
* @param string $handleMsg 处理消息
|
||||
* @param int $handleResult 处理结果,1同意,2拒绝
|
||||
* @return array
|
||||
*/
|
||||
public function addFriendResponse(string $ownerUserID, string $friendUserID, string $handleMsg, int $handleResult): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'ownerUserID' => $ownerUserID,
|
||||
'friendUserID' => $friendUserID,
|
||||
'handleMsg' => $handleMsg,
|
||||
'handleResult' => $handleResult
|
||||
];
|
||||
return Utils::send(Url::$addFriendResponse, $data, '同意/拒绝好友请求错误', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 删除好友
|
||||
* @param string $ownerUserID 用户ID
|
||||
* @param string $friendUserID 好友ID
|
||||
* @return array
|
||||
*/
|
||||
public function deleteFriend(string $ownerUserID, string $friendUserID): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = ['ownerUserID' => $ownerUserID, 'friendUserID' => $friendUserID];
|
||||
return Utils::send(Url::$deleteFriend, $data, '删除好友错误', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取黑名单列表
|
||||
* @param string $userID 用户ID
|
||||
* @return array
|
||||
*/
|
||||
public function getBlackList(string $userID): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
return Utils::send(Url::$getBlackList, ['userID' => $userID], '获取黑名单列表错误', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取好友申请列表(收到的申请)
|
||||
* @param string $userID 用户ID
|
||||
* @return array
|
||||
*/
|
||||
public function getFriendApplyList(string $userID): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
return Utils::send(Url::$getFriendApplyList, ['userID' => $userID], '获取好友申请列表错误', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取用户的好友列表
|
||||
* @param string $userID 用户ID
|
||||
* @return array
|
||||
*/
|
||||
public function getFriendList(string $userID): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
return Utils::send(Url::$getFriendList, ['userID' => $userID], '获取用户的好友列表错误', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取自己的好友申请列表(发出的申请)
|
||||
* @param string $userID 用户ID
|
||||
* @return array
|
||||
*/
|
||||
public function getSelfFriendApplyList(string $userID): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
return Utils::send(Url::$getSelfFriendApplyList, ['userID' => $userID], '获取自己的好友申请列表错误', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 批量导入好友
|
||||
* @param string $ownerUserID 用户ID
|
||||
* @param array $friendUserIDs 好友ID列表
|
||||
* @return array
|
||||
*/
|
||||
public function importFriend(string $ownerUserID, array $friendUserIDs = []): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = ['ownerUserID' => $ownerUserID, 'friendUserIDs' => $friendUserIDs];
|
||||
return Utils::send(Url::$importFriend, $data, '批量导入好友错误', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 检查用户之间是否为好友
|
||||
* @param string $userID1 用户ID1
|
||||
* @param string $userID2 用户ID2
|
||||
* @return array
|
||||
*/
|
||||
public function isFriend(string $userID1, string $userID2): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = ['userID1' => $userID1, 'userID2' => $userID2];
|
||||
return Utils::send(Url::$isFriend, $data, '检查用户之间是否为好友错误', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 把用户移除黑名单
|
||||
* @param string $ownerUserID 用户ID
|
||||
* @param string $blackUserID 被移除黑名单的用户ID
|
||||
* @return array
|
||||
*/
|
||||
public function removeBlack(string $ownerUserID, string $blackUserID): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = ['ownerUserID' => $ownerUserID, 'blackUserID' => $blackUserID];
|
||||
return Utils::send(Url::$removeBlack, $data, '把用户移除黑名单错误', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 设置好友备注
|
||||
* @param string $fromUserID 用户ID
|
||||
* @param string $toUserID 好友ID
|
||||
* @param string $remark 备注
|
||||
* @return array
|
||||
*/
|
||||
public function setFriendRemark(string $fromUserID, string $toUserID, string $remark): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = ['fromUserID' => $fromUserID, 'toUserID' => $toUserID, 'remark' => $remark];
|
||||
return Utils::send(Url::$setFriendRemark, $data, '设置好友备注错误', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 更新好友信息
|
||||
* @param string $ownerUserID 用户ID
|
||||
* @param string $friendUserID 好友ID
|
||||
* @param string $remark 备注
|
||||
* @param bool $isPinned 是否置顶
|
||||
* @param string $ex 扩展字段
|
||||
* @return array
|
||||
*/
|
||||
public function updateFriends(string $ownerUserID, string $friendUserID, string $remark = '', bool $isPinned = false, string $ex = ''): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'ownerUserID' => $ownerUserID,
|
||||
'friendUserID' => $friendUserID
|
||||
];
|
||||
|
||||
// 只添加非空参数
|
||||
if ($remark !== '') {
|
||||
$data['remark'] = $remark;
|
||||
}
|
||||
|
||||
if ($isPinned) {
|
||||
$data['isPinned'] = $isPinned;
|
||||
}
|
||||
|
||||
if ($ex !== '') {
|
||||
$data['ex'] = $ex;
|
||||
}
|
||||
|
||||
return Utils::send(Url::$updateFriends, $data, '更新好友信息失败', $adminToken);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,391 @@
|
||||
<?php
|
||||
|
||||
namespace support\OpenImSdk\Api;
|
||||
|
||||
use support\OpenImSdk\Core\Url;
|
||||
use support\OpenImSdk\Core\Utils;
|
||||
|
||||
class Group
|
||||
{
|
||||
/**
|
||||
* 创建群组
|
||||
* @param string $ownerUserID 群主ID
|
||||
* @param array $memberUserIDs 普通成员ID列表
|
||||
* @param array $adminUserIDs 管理员ID列表
|
||||
* @param string $groupName 群名称
|
||||
* @param string $groupID 群ID,可选
|
||||
* @param string $faceURL 群头像
|
||||
* @param string $introduction 群简介
|
||||
* @param string $notification 群公告
|
||||
* @param string $ex 扩展字段
|
||||
* @param int $groupType 群类型,固定为2
|
||||
* @param int $needVerification 加群验证方式
|
||||
* @param int $lookMemberInfo 查看群成员信息权限
|
||||
* @param int $applyMemberFriend 群内加好友权限
|
||||
* @return array
|
||||
*/
|
||||
public function createGroup(string $ownerUserID, array $memberUserIDs = [], array $adminUserIDs = [], string $groupName = '',
|
||||
string $groupID = '', string $faceURL = '', string $introduction = '', string $notification = '',
|
||||
string $ex = '', int $groupType = 2, int $needVerification = 0, int $lookMemberInfo = 0, int $applyMemberFriend = 0): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'ownerUserID' => $ownerUserID,
|
||||
'memberUserIDs' => $memberUserIDs,
|
||||
'adminUserIDs' => $adminUserIDs,
|
||||
'groupInfo' => [
|
||||
'groupID' => $groupID,
|
||||
'groupName' => $groupName,
|
||||
'notification' => $notification,
|
||||
'introduction' => $introduction,
|
||||
'faceURL' => $faceURL,
|
||||
'ex' => $ex,
|
||||
'groupType' => $groupType,
|
||||
'needVerification' => $needVerification,
|
||||
'lookMemberInfo' => $lookMemberInfo,
|
||||
'applyMemberFriend' => $applyMemberFriend
|
||||
]
|
||||
];
|
||||
return Utils::send(Url::$createGroup, $data, '创建群组失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 申请加入群组
|
||||
* @param string $token 用户token
|
||||
* @param string $groupID 群组ID
|
||||
* @param string $reqMsg 申请消息
|
||||
* @param int $joinSource 加入来源
|
||||
* @return array
|
||||
*/
|
||||
public function joinGroup(string $token, string $groupID, string $reqMsg = '', int $joinSource = 0): array
|
||||
{
|
||||
$data = [
|
||||
'groupID' => $groupID,
|
||||
'reqMsg' => $reqMsg,
|
||||
'joinSource' => $joinSource
|
||||
];
|
||||
return Utils::send(Url::$joinGroup, $data, '申请加入群组失败', $token);
|
||||
}
|
||||
|
||||
/**
|
||||
* 退出群组
|
||||
* @param string $token 用户token
|
||||
* @param string $groupID 群组ID
|
||||
* @return array
|
||||
*/
|
||||
public function quitGroup(string $token, string $groupID): array
|
||||
{
|
||||
return Utils::send(Url::$quitGroup, ['groupID' => $groupID], '退出群组失败', $token);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取群组信息
|
||||
* @param array $groupIDs 群组ID列表
|
||||
* @return array
|
||||
*/
|
||||
public function getGroupsInfo(array $groupIDs): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
return Utils::send(Url::$getGroupsInfo, ['groupIDs' => $groupIDs], '获取群组信息失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取群成员列表
|
||||
* @param string $groupID 群组ID
|
||||
* @param int $filter 过滤类型,0所有,1群主,2管理员,3普通成员,4禁言,5进入黑名单
|
||||
* @param int $offset 偏移量
|
||||
* @param int $count 数量
|
||||
* @return array
|
||||
*/
|
||||
public function getGroupMemberList(string $groupID, int $filter = 0, int $offset = 0, int $count = 100): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'groupID' => $groupID,
|
||||
'filter' => $filter,
|
||||
'offset' => $offset,
|
||||
'count' => $count
|
||||
];
|
||||
return Utils::send(Url::$getGroupMemberList, $data, '获取群成员列表失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取指定群成员信息
|
||||
* @param string $groupID 群组ID
|
||||
* @param array $userIDs 用户ID列表
|
||||
* @return array
|
||||
*/
|
||||
public function getGroupMembersInfo(string $groupID, array $userIDs): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'groupID' => $groupID,
|
||||
'userIDs' => $userIDs
|
||||
];
|
||||
return Utils::send(Url::$getGroupMembersInfo, $data, '获取指定群成员信息失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 将用户拉入群组
|
||||
* @param string $groupID 群组ID
|
||||
* @param string $inviterUserID 邀请者ID
|
||||
* @param array $invitedUserIDList 被邀请的用户ID列表
|
||||
* @param string $reason 邀请原因
|
||||
* @return array
|
||||
*/
|
||||
public function inviteUserToGroup(string $groupID, string $inviterUserID, array $invitedUserIDList, string $reason = ''): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'groupID' => $groupID,
|
||||
'inviterUserID' => $inviterUserID,
|
||||
'invitedUserIDList' => $invitedUserIDList,
|
||||
'reason' => $reason,
|
||||
];
|
||||
return Utils::send(Url::$inviteUserToGroup, $data, '将用户拉入群组失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 踢出群成员
|
||||
* @param string $groupID 群组ID
|
||||
* @param string $kickUserID 踢出者ID
|
||||
* @param array $kickedUserIDs 被踢出的用户ID列表
|
||||
* @param string $reason 踢出原因
|
||||
* @return array
|
||||
*/
|
||||
public function kickGroupMember(string $groupID, string $kickUserID, array $kickedUserIDs, string $reason = ''): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'groupID' => $groupID,
|
||||
'kickUserID' => $kickUserID,
|
||||
'kickedUserIDs' => $kickedUserIDs,
|
||||
'reason' => $reason
|
||||
];
|
||||
return Utils::send(Url::$kickGroupMember, $data, '踢出群成员失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 转让群主
|
||||
* @param string $groupID 群组ID
|
||||
* @param string $oldOwnerUserID 原群主ID
|
||||
* @param string $newOwnerUserID 新群主ID
|
||||
* @return array
|
||||
*/
|
||||
public function transferGroupOwner(string $groupID, string $oldOwnerUserID, string $newOwnerUserID): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'groupID' => $groupID,
|
||||
'oldOwnerUserID' => $oldOwnerUserID,
|
||||
'newOwnerUserID' => $newOwnerUserID
|
||||
];
|
||||
return Utils::send(Url::$transferGroupOwner, $data, '转让群主失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取用户加入的群组列表
|
||||
* @param string $userID 用户ID
|
||||
* @return array
|
||||
*/
|
||||
public function getJoinedGroupList(string $userID): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
return Utils::send(Url::$getJoinedGroupList, ['userID' => $userID], '获取用户加入的群组列表失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 解散群组
|
||||
* @param string $groupID 群组ID
|
||||
* @return array
|
||||
*/
|
||||
public function dismissGroup(string $groupID): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
return Utils::send(Url::$dismissGroup, ['groupID' => $groupID], '解散群组失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 设置群成员昵称
|
||||
* @param string $groupID 群组ID
|
||||
* @param string $userID 用户ID
|
||||
* @param string $nickname 群内昵称
|
||||
* @return array
|
||||
*/
|
||||
public function setGroupMemberNickname(string $groupID, string $userID, string $nickname): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'groupID' => $groupID,
|
||||
'userID' => $userID,
|
||||
'nickname' => $nickname
|
||||
];
|
||||
return Utils::send(Url::$setGroupMemberNickname, $data, '设置群成员昵称失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 设置群成员信息
|
||||
* @param string $groupID 群组ID
|
||||
* @param string $userID 用户ID
|
||||
* @param array $data 群成员信息
|
||||
* @return array
|
||||
*/
|
||||
public function setGroupMemberInfo(string $groupID, string $userID, array $data): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = array_merge([
|
||||
'groupID' => $groupID,
|
||||
'userID' => $userID
|
||||
], $data);
|
||||
return Utils::send(Url::$setGroupMemberInfo, $data, '设置群成员信息失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取群成员用户ID列表
|
||||
* @param string $groupID 群组ID
|
||||
* @return array
|
||||
*/
|
||||
public function getGroupMemberUserIDs(string $groupID): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
return Utils::send(Url::$getGroupMemberUserIDs, ['groupID' => $groupID], '获取群成员用户ID列表失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取群成员列表
|
||||
* @param string $groupID 群组ID
|
||||
* @param int $offset 偏移量
|
||||
* @param int $count 数量
|
||||
* @return array
|
||||
*/
|
||||
public function getGroupAllMemberList(string $groupID, int $offset = 0, int $count = 100): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'groupID' => $groupID,
|
||||
'pagination' => [
|
||||
'pageNumber' => intval($offset / $count) + 1,
|
||||
'showNumber' => $count
|
||||
]
|
||||
];
|
||||
return Utils::send(Url::$getGroupAllMemberList, $data, '获取群成员列表失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取用户加群申请列表
|
||||
* @param string $userID 用户ID
|
||||
* @return array
|
||||
*/
|
||||
public function getUserReqGroupApplicationList(string $userID): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
return Utils::send(Url::$getUserReqGroupApplicationList, ['userID' => $userID], '获取用户加群申请列表失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取指定用户对指定群组的加群请求
|
||||
* @param string $groupID 群组ID
|
||||
* @param array $userIDs 用户ID列表
|
||||
* @return array
|
||||
*/
|
||||
public function getGroupApplicationListByUserID(string $groupID, array $userIDs): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'groupID' => $groupID,
|
||||
'userIDs' => $userIDs
|
||||
];
|
||||
return Utils::send(Url::$getGroupUsersReqApplicationList, $data, '获取指定用户对指定群组的加群请求失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 处理群组申请
|
||||
* @param string $groupID 群组ID
|
||||
* @param string $fromUserID 申请者ID
|
||||
* @param string $handledUserID 处理者ID
|
||||
* @param int $handleResult 处理结果,1同意,2拒绝
|
||||
* @param string $handleMsg 处理消息
|
||||
* @return array
|
||||
*/
|
||||
public function groupApplicationResponse(string $groupID, string $fromUserID, string $handledUserID, int $handleResult, string $handleMsg = ''): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'groupID' => $groupID,
|
||||
'fromUserID' => $fromUserID,
|
||||
'handledUserID' => $handledUserID,
|
||||
'handleResult' => $handleResult,
|
||||
'handleMsg' => $handleMsg
|
||||
];
|
||||
return Utils::send(Url::$groupApplicationResponse, $data, '处理群组申请失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 禁言群组,只有群主和管理员可以发送消息
|
||||
* @param string $groupID 群组ID
|
||||
* @return array
|
||||
*/
|
||||
public function muteGroup(string $groupID): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
return Utils::send(Url::$muteGroup, ['groupID' => $groupID], '禁言群组失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 取消禁言群组,所有成员都可以发送消息
|
||||
* @param string $groupID 群组ID
|
||||
* @return array
|
||||
*/
|
||||
public function cancelMuteGroup(string $groupID): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
return Utils::send(Url::$cancelMuteGroup, ['groupID' => $groupID], '取消禁言群组失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 禁言群成员
|
||||
* @param string $groupID 群组ID
|
||||
* @param string $userID 群成员ID
|
||||
* @param int $mutedSeconds 禁言时间(秒)
|
||||
* @return array
|
||||
*/
|
||||
public function muteGroupMember(string $groupID, string $userID, int $mutedSeconds = 0): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = ['groupID' => $groupID, 'userID' => $userID, 'mutedSeconds' => $mutedSeconds];
|
||||
return Utils::send(Url::$muteGroupMember, $data, '禁言群成员失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 取消禁言群成员
|
||||
* @param string $groupID 群组ID
|
||||
* @param string $userID 群成员ID
|
||||
* @return array
|
||||
*/
|
||||
public function cancelMuteGroupMember(string $groupID, string $userID): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = ['groupID' => $groupID, 'userID' => $userID];
|
||||
return Utils::send(Url::$cancelMuteGroupMember, $data, '取消禁言群成员失败', $adminToken);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,217 @@
|
||||
<?php
|
||||
|
||||
namespace support\OpenImSdk\Api;
|
||||
|
||||
use support\OpenImSdk\Core\Url;
|
||||
use support\OpenImSdk\Core\Utils;
|
||||
|
||||
class Message
|
||||
{
|
||||
/**
|
||||
* 发送消息
|
||||
* @param string $sendID 发送者ID
|
||||
* @param string $recvID 接收者ID,单聊时必填
|
||||
* @param string $groupID 群组ID,群聊时必填
|
||||
* @param string $senderNickname 发送者昵称
|
||||
* @param string $senderFaceURL 发送者头像
|
||||
* @param int $senderPlatformID 发送者平台ID
|
||||
* @param array $content 消息内容
|
||||
* @param int $contentType 消息类型
|
||||
* @param int $sessionType 会话类型,1单聊,2群聊
|
||||
* @param bool $isOnlineOnly 是否仅在线用户接收
|
||||
* @param bool $notOfflinePush 是否不离线推送
|
||||
* @param int $sendTime 发送时间,毫秒
|
||||
* @param array $offlinePushInfo 离线推送信息
|
||||
* @param string $ex 扩展字段
|
||||
* @return array
|
||||
*/
|
||||
public function sendMsg(string $sendID, string $recvID = '', string $groupID = '', string $senderNickname = '', string $senderFaceURL = '', int $senderPlatformID = 1, array $content = [], int $contentType = 101, int $sessionType = 1, bool $isOnlineOnly = false, bool $notOfflinePush = false, int $sendTime = 0, array $offlinePushInfo = [], string $ex = ''): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'sendID' => $sendID,
|
||||
'senderNickname' => $senderNickname,
|
||||
'senderFaceURL' => $senderFaceURL,
|
||||
'senderPlatformID' => $senderPlatformID,
|
||||
'contentType' => $contentType,
|
||||
'sessionType' => $sessionType,
|
||||
'isOnlineOnly' => $isOnlineOnly,
|
||||
'notOfflinePush' => $notOfflinePush,
|
||||
'ex' => $ex
|
||||
];
|
||||
|
||||
// 根据会话类型设置recvID或groupID
|
||||
if ($sessionType == 1 && !empty($recvID)) {
|
||||
$data['recvID'] = $recvID;
|
||||
} elseif ($sessionType == 2 && !empty($groupID)) {
|
||||
$data['groupID'] = $groupID;
|
||||
}
|
||||
|
||||
// 设置消息内容
|
||||
if (empty($content)) {
|
||||
$data['content'] = ['text' => ''];
|
||||
} else {
|
||||
$data['content'] = $content;
|
||||
}
|
||||
|
||||
// 设置发送时间,如果有的话
|
||||
if ($sendTime > 0) {
|
||||
$data['sendTime'] = $sendTime;
|
||||
}
|
||||
|
||||
// 设置离线推送信息,如果有的话
|
||||
if (!empty($offlinePushInfo)) {
|
||||
$data['offlinePushInfo'] = $offlinePushInfo;
|
||||
}
|
||||
|
||||
return Utils::send(Url::$sendMsg, $data, '发送消息失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 批量发送消息
|
||||
* @param string $sendID 发送者ID
|
||||
* @param string $senderNickname 发送者昵称
|
||||
* @param string $senderFaceURL 发送者头像
|
||||
* @param int $sessionType 会话类型
|
||||
* @param int $contentType 消息类型
|
||||
* @param string $content 消息内容
|
||||
* @return array
|
||||
*/
|
||||
public function batchSendMsg(string $sendID, string $senderNickname, string $senderFaceURL, int $sessionType, int $contentType, string $content): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'senderPlatformID' => 0,
|
||||
'sendID' => $sendID,
|
||||
'senderNickname' => $senderNickname,
|
||||
'senderFaceURL' => $senderFaceURL,
|
||||
'sessionType' => $sessionType,
|
||||
'contentType' => $contentType,
|
||||
'content' => ['text' => $content]
|
||||
];
|
||||
return Utils::send(Url::$batchSendMsg, $data, '批量发送消息失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 清空用户消息
|
||||
* @param string $userID 用户ID
|
||||
* @return array
|
||||
*/
|
||||
public function clearMsg(string $userID): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
return Utils::send(Url::$clearMsg, ['userID' => $userID], '清空用户消息失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 根据seq列表删除消息
|
||||
* @param string $userID 用户ID
|
||||
* @param string $conversationID 会话ID
|
||||
* @param array $seqs seq列表
|
||||
* @return array
|
||||
*/
|
||||
public function delMsg(string $userID, string $conversationID, array $seqs): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'userID' => $userID,
|
||||
'conversationID' => $conversationID,
|
||||
'seqs' => $seqs
|
||||
];
|
||||
return Utils::send(Url::$delMsg, $data, '删除消息失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 撤回消息
|
||||
* @param string $conversationID 会话ID
|
||||
* @param string $seq 消息seq
|
||||
* @param string $userID 用户ID
|
||||
* @return array
|
||||
*/
|
||||
public function revokeMessage(string $conversationID, string $seq, string $userID): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'conversationID' => $conversationID,
|
||||
'seq' => intval($seq),
|
||||
'userID' => $userID
|
||||
];
|
||||
return Utils::send(Url::$revokeMessage, $data, '撤回消息失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 发送业务通知
|
||||
* @param string $sendID 发送者ID
|
||||
* @param string $recvID 接收者ID
|
||||
* @param string $title 通知标题
|
||||
* @param string $content 通知内容
|
||||
* @param string $notificationUrl 通知点击跳转链接
|
||||
* @param string $ex 扩展字段
|
||||
* @return array
|
||||
*/
|
||||
public function sendBusinessNotification(string $sendID, string $recvID, string $title, string $content, string $notificationUrl = '', string $ex = ''): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'sendID' => $sendID,
|
||||
'recvID' => $recvID,
|
||||
'title' => $title,
|
||||
'content' => $content,
|
||||
'notificationUrl' => $notificationUrl,
|
||||
'ex' => $ex
|
||||
];
|
||||
return Utils::send(Url::$sendBusinessNotification, $data, '发送业务通知失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取用户所有会话
|
||||
* @param string $userID 用户ID
|
||||
* @return array
|
||||
*/
|
||||
public function getAllConversations(string $userID): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
return Utils::send(Url::$getAllConversations, ['userID' => $userID], '获取用户所有会话失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 根据会话ID获取会话
|
||||
* @param string $userID 用户ID
|
||||
* @param string $conversationID 会话ID
|
||||
* @return array
|
||||
*/
|
||||
public function getConversation(string $userID, string $conversationID): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'userID' => $userID,
|
||||
'conversationID' => $conversationID
|
||||
];
|
||||
return Utils::send(Url::$getConversation, $data, '获取会话失败', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 根据会话ID列表获取会话
|
||||
* @param string $userID 用户ID
|
||||
* @param array $conversationIDs 会话ID列表
|
||||
* @return array
|
||||
*/
|
||||
public function getConversations(string $userID, array $conversationIDs): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'userID' => $userID,
|
||||
'conversationIDs' => $conversationIDs
|
||||
];
|
||||
return Utils::send(Url::$getConversations, $data, '获取会话列表失败', $adminToken);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,262 @@
|
||||
<?php
|
||||
|
||||
namespace support\OpenImSdk\Api;
|
||||
|
||||
use support\OpenImSdk\Core\Url;
|
||||
use support\OpenImSdk\Core\Utils;
|
||||
|
||||
class User
|
||||
{
|
||||
/**
|
||||
* 获取用户列表
|
||||
* @param int $pagination 页码
|
||||
* @param int $showNumber 每页数量
|
||||
* @return array
|
||||
*/
|
||||
public function getUsers(int $pagination = 1, int $showNumber = 20): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'pagination' => [
|
||||
'pageNumber' => $pagination,
|
||||
'showNumber' => $showNumber
|
||||
]
|
||||
];
|
||||
return Utils::send(Url::$getUsers, $data, '获取用户列表错误', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取用户在线状态
|
||||
* @param array $userIDList 用户ID列表
|
||||
* @return array
|
||||
*/
|
||||
public function getUsersOnlineStatus(array $userIDList): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
return Utils::send(Url::$getUsersOnlineStatus, ['userIDList' => $userIDList], '获取用户在线状态错误', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取用户在线token详情
|
||||
* @param array $userIDList 用户ID列表
|
||||
* @return array
|
||||
*/
|
||||
public function getUsersOnlineTokenDetail(array $userIDList): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
return Utils::send(Url::$getUsersOnlineTokenDetail, ['userIDList' => $userIDList], '获取用户在线token详情错误', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取订阅用户状态
|
||||
* @return array
|
||||
*/
|
||||
public function getSubscribeUsersStatus(): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
return Utils::send(Url::$getSubscribeUsersStatus, [], '获取订阅用户状态错误', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 订阅用户状态
|
||||
* @param string $token 管理员token
|
||||
* @param array $userIDList 用户ID列表
|
||||
* @return array
|
||||
*/
|
||||
public function subscribeUsersStatus(array $userIDList): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
return Utils::send(Url::$subscribeUsersStatus, ['userIDList' => $userIDList], '订阅用户状态错误', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 设置全局免打扰
|
||||
* @param int $globalRecvMsgOpt 全局消息接收选项
|
||||
* @return array
|
||||
*/
|
||||
public function setGlobalMsgRecvOpt(int $globalRecvMsgOpt): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
return Utils::send(Url::$setGlobalMsgRecvOpt, ['globalRecvMsgOpt' => $globalRecvMsgOpt], '设置全局免打扰错误', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 修改用户信息
|
||||
* @param string $userID 用户ID
|
||||
* @param array $data 用户信息
|
||||
* @return array
|
||||
*/
|
||||
public function updateUserInfo(string $userID, array $data): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = array_merge(['userID' => $userID], $data);
|
||||
return Utils::send(Url::$updateUserInfo, $data, '修改用户信息错误', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 搜索通知账号
|
||||
* @param string $keyword 搜索关键词
|
||||
* @param int $pagination 页码
|
||||
* @param int $showNumber 每页数量
|
||||
* @return array
|
||||
*/
|
||||
public function searchNotificationAccount(string $keyword, int $pagination = 1, int $showNumber = 20): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'keyword' => $keyword,
|
||||
'pagination' => [
|
||||
'pageNumber' => $pagination,
|
||||
'showNumber' => $showNumber
|
||||
]
|
||||
];
|
||||
return Utils::send(Url::$searchNotificationAccount, $data, '搜索通知账号错误', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 添加通知账号
|
||||
* @param string $userID 用户ID
|
||||
* @param string $nickname 昵称
|
||||
* @param string $faceURL 头像
|
||||
* @param int $gender 性别
|
||||
* @param string $phoneNumber 手机号
|
||||
* @param string $birth 生日
|
||||
* @param string $email 邮箱
|
||||
* @param string $ex 扩展字段
|
||||
* @return array
|
||||
*/
|
||||
public function addNotificationAccount(string $userID, string $nickname = '', string $faceURL = '', int $gender = 1, string $phoneNumber = '', string $birth = '', string $email = '', string $ex = ''): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'userID' => $userID,
|
||||
'nickname' => $nickname,
|
||||
'faceURL' => $faceURL,
|
||||
'gender' => $gender,
|
||||
'phoneNumber' => $phoneNumber,
|
||||
'birth' => $birth,
|
||||
'email' => $email,
|
||||
'ex' => $ex
|
||||
];
|
||||
return Utils::send(Url::$addNotificationAccount, $data, '添加通知账号错误');
|
||||
}
|
||||
|
||||
/**
|
||||
* 更新通知账号
|
||||
* @param string $userID 用户ID
|
||||
* @param string $nickname 昵称
|
||||
* @param string $faceURL 头像
|
||||
* @param int $gender 性别
|
||||
* @param string $phoneNumber 手机号
|
||||
* @param string $birth 生日
|
||||
* @param string $email 邮箱
|
||||
* @param string $ex 扩展字段
|
||||
* @return array
|
||||
*/
|
||||
public function updateNotificationAccount(string $userID, string $nickname = '', string $faceURL = '', int $gender = 1, string $phoneNumber = '', string $birth = '', string $email = '', string $ex = ''): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'userID' => $userID,
|
||||
'nickname' => $nickname,
|
||||
'faceURL' => $faceURL,
|
||||
'gender' => $gender,
|
||||
'phoneNumber' => $phoneNumber,
|
||||
'birth' => $birth,
|
||||
'email' => $email,
|
||||
'ex' => $ex
|
||||
];
|
||||
return Utils::send(Url::$updateNotificationAccount, $data, '更新通知账号错误', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 检查列表账户注册状态
|
||||
* @param array $checkUserIDList 用户ID列表
|
||||
* @return array
|
||||
*/
|
||||
public function accountCheck(array $checkUserIDList): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
return Utils::send(Url::$accountCheck, ['checkUserIDList' => $checkUserIDList], '检查列表账户注册状态错误', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取所有用户uid列表
|
||||
* @return array
|
||||
*/
|
||||
public function getAllUsersUid($page=1,$limit=100): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
return Utils::send(Url::$getAllUsersUid, ['pagination'=>['pageNumber'=>$page,"showNumber"=>$limit]], '获取所有用户uid列表错误', $adminToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取自己的信息
|
||||
* @param string $userID 用户ID
|
||||
* @return array
|
||||
*/
|
||||
public function getSelfUserInfo(string $userID): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$userToken = Utils::getUserToken($userID);
|
||||
return Utils::send(Url::$getSelfUserInfo, ['userID' => $userID], '获取自己的信息错误', $userToken);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取用户信息
|
||||
* @param array $userIDList 用户ID列表
|
||||
* @return array
|
||||
*/
|
||||
public function getUsersInfo(array $userIDList): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
return Utils::send(Url::$getUsersInfo, ['userIDList' => $userIDList], '获取用户信息错误', $adminToken);
|
||||
}
|
||||
|
||||
//Header
|
||||
//
|
||||
//Header Name Example Value Required Type Description
|
||||
//operationID 1646445464564 Required string Used for global traceability, suggested as a unique timestamp per request
|
||||
//token eyJhbxxxx3Xs Required string Admin token
|
||||
|
||||
//Field Name Required Type Description
|
||||
//users Required array List of users
|
||||
//users.userID Required string User ID
|
||||
//users.nickname Required string User nickname
|
||||
//users.faceURL Required string User avatar URL
|
||||
/**
|
||||
* 用户注册
|
||||
* @param string $userID 用户ID
|
||||
* @param string $nickname 昵称
|
||||
* @param string $faceURL 头像地址
|
||||
* @return array
|
||||
*/
|
||||
public function userRegister(string $userID, string $nickname = '', string $faceURL = ''): array
|
||||
{
|
||||
// 获取管理员token
|
||||
$adminToken = Utils::getAdminToken();
|
||||
$data = [
|
||||
'users' => [
|
||||
[
|
||||
'userID' => $userID,
|
||||
'nickname' => $nickname,
|
||||
'faceURL' => $faceURL
|
||||
]
|
||||
]
|
||||
];
|
||||
return Utils::send(Url::$userRegister, $data, '注册IM错误', $adminToken);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,75 @@
|
||||
<?php
|
||||
|
||||
namespace support\OpenImSdk;
|
||||
|
||||
use support\OpenImSdk\Api\Auth;
|
||||
use support\OpenImSdk\Api\Conversation;
|
||||
use support\OpenImSdk\Api\Friend;
|
||||
use support\OpenImSdk\Api\Group;
|
||||
use support\OpenImSdk\Api\Message;
|
||||
use support\OpenImSdk\Api\User;
|
||||
use support\OpenImSdk\Core\Config;
|
||||
use support\OpenImSdk\Core\TokenManager;
|
||||
use support\OpenImSdk\Core\Utils;
|
||||
|
||||
class Client
|
||||
{
|
||||
/**
|
||||
* 认证相关
|
||||
* @var Auth
|
||||
*/
|
||||
public $auth;
|
||||
|
||||
/**
|
||||
* 好友相关
|
||||
* @var Friend
|
||||
*/
|
||||
public $friend;
|
||||
|
||||
/**
|
||||
* 群组相关
|
||||
* @var Group
|
||||
*/
|
||||
public $group;
|
||||
|
||||
/**
|
||||
* 消息相关
|
||||
* @var Message
|
||||
*/
|
||||
public $message;
|
||||
|
||||
/**
|
||||
* 用户相关
|
||||
* @var User
|
||||
*/
|
||||
public $user;
|
||||
|
||||
/**
|
||||
* 会话相关
|
||||
* @var Conversation
|
||||
*/
|
||||
public $conversation;
|
||||
|
||||
/**
|
||||
* 初始化客户端
|
||||
* @param array $config 配置信息
|
||||
*/
|
||||
public function __construct(array $config)
|
||||
{
|
||||
// 设置基本配置
|
||||
Config::setConfig($config);
|
||||
|
||||
$tokenManager = new TokenManager();
|
||||
|
||||
// 设置TokenManager
|
||||
Utils::setTokenManager($tokenManager);
|
||||
|
||||
// 初始化API类
|
||||
$this->auth = new Auth();
|
||||
$this->friend = new Friend();
|
||||
$this->group = new Group();
|
||||
$this->message = new Message();
|
||||
$this->user = new User();
|
||||
$this->conversation = new Conversation();
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,39 @@
|
||||
<?php
|
||||
|
||||
namespace support\OpenImSdk\Core;
|
||||
|
||||
class Config
|
||||
{
|
||||
private static $config = [
|
||||
'host' => 'http://127.0.0.1:10002',
|
||||
'secret' => 'openIM123',
|
||||
];
|
||||
|
||||
/**
|
||||
* 设置配置项
|
||||
* @param array $config
|
||||
* @return void
|
||||
*/
|
||||
public static function setConfig(array $config)
|
||||
{
|
||||
self::$config = array_merge(self::$config, $config);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取密钥
|
||||
* @return string
|
||||
*/
|
||||
public static function getSecret(): string
|
||||
{
|
||||
return self::$config['secret'];
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取API主机地址
|
||||
* @return string
|
||||
*/
|
||||
public static function getHost(): string
|
||||
{
|
||||
return self::$config['host'];
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,157 @@
|
||||
<?php
|
||||
|
||||
namespace support\OpenImSdk\Core;
|
||||
|
||||
use Exception;
|
||||
|
||||
class TokenManager
|
||||
{
|
||||
/**
|
||||
* 默认Token过期时间(秒)
|
||||
* 仅在API未返回过期时间时使用
|
||||
* @var int
|
||||
*/
|
||||
private $defaultTokenExpire = 86400; // 默认24小时
|
||||
|
||||
/**
|
||||
* 构造函数
|
||||
*/
|
||||
public function __construct()
|
||||
{
|
||||
}
|
||||
|
||||
/**
|
||||
* 设置默认Token过期时间
|
||||
* @param int $seconds 过期时间(秒)
|
||||
* @return $this
|
||||
*/
|
||||
public function setDefaultTokenExpire(int $seconds)
|
||||
{
|
||||
$this->defaultTokenExpire = $seconds;
|
||||
return $this;
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取管理员Token
|
||||
* @param string $userID 管理员ID
|
||||
* @return string|null
|
||||
*/
|
||||
public function getAdminToken(string $userID = 'imAdmin'): ?string
|
||||
{
|
||||
$key = "admin_token_{$userID}";
|
||||
$tokenData = $this->getCache($key);
|
||||
|
||||
if (!$tokenData) {
|
||||
// Token不存在或已过期,需要重新获取
|
||||
return null;
|
||||
}
|
||||
|
||||
$data = json_decode($tokenData, true);
|
||||
return $data['token'] ?? null;
|
||||
}
|
||||
|
||||
/**
|
||||
* 保存管理员Token
|
||||
* @param string $userID 管理员ID
|
||||
* @param string $token Token
|
||||
* @param int|null $expireTimeSeconds Token过期时间(秒)
|
||||
* @return bool
|
||||
*/
|
||||
public function saveAdminToken(string $userID, string $token, ?int $expireTimeSeconds = null): bool
|
||||
{
|
||||
$key = "admin_token_{$userID}";
|
||||
$expireTime = $expireTimeSeconds ?? $this->defaultTokenExpire;
|
||||
|
||||
// 存储token和过期时间
|
||||
$data = [
|
||||
'token' => $token,
|
||||
'expireTimeSeconds' => $expireTime
|
||||
];
|
||||
|
||||
return $this->setCache($key, json_encode($data), $expireTime);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取用户Token
|
||||
* @param string $userID 用户ID
|
||||
* @return string|null
|
||||
*/
|
||||
public function getUserToken(string $userID): ?string
|
||||
{
|
||||
$key = "user_token_{$userID}";
|
||||
$tokenData = $this->getCache($key);
|
||||
|
||||
if (!$tokenData) {
|
||||
// Token不存在或已过期,需要重新获取
|
||||
return null;
|
||||
}
|
||||
|
||||
$data = json_decode($tokenData, true);
|
||||
return $data['token'] ?? null;
|
||||
}
|
||||
|
||||
/**
|
||||
* 保存用户Token
|
||||
* @param string $userID 用户ID
|
||||
* @param string $token Token
|
||||
* @param int|null $expireTimeSeconds Token过期时间(秒)
|
||||
* @return bool
|
||||
*/
|
||||
public function saveUserToken(string $userID, string $token, ?int $expireTimeSeconds = null): bool
|
||||
{
|
||||
$key = "user_token_{$userID}";
|
||||
$expireTime = $expireTimeSeconds ?? $this->defaultTokenExpire;
|
||||
|
||||
// 存储token和过期时间
|
||||
$data = [
|
||||
'token' => $token,
|
||||
'expireTimeSeconds' => $expireTime
|
||||
];
|
||||
|
||||
return $this->setCache($key, json_encode($data), $expireTime);
|
||||
}
|
||||
|
||||
/**
|
||||
* 清除Token
|
||||
* @param string $userID 用户ID
|
||||
* @param bool $isAdmin 是否为管理员Token
|
||||
* @return bool
|
||||
*/
|
||||
public function clearToken(string $userID, bool $isAdmin = false): bool
|
||||
{
|
||||
$key = $isAdmin ? "admin_token_{$userID}" : "user_token_{$userID}";
|
||||
return $this->deleteCache($key);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取缓存
|
||||
* @param string $key 缓存键
|
||||
* @return string|null
|
||||
*/
|
||||
private function getCache(string $key): ?string
|
||||
{
|
||||
return cache($key);
|
||||
}
|
||||
|
||||
/**
|
||||
* 设置缓存
|
||||
* @param string $key 缓存键
|
||||
* @param string $value 缓存值
|
||||
* @param int $expire 过期时间(秒)
|
||||
* @return bool
|
||||
*/
|
||||
private function setCache(string $key, string $value, int $expire): bool
|
||||
{
|
||||
return cache($key,$value,$expire);
|
||||
}
|
||||
|
||||
/**
|
||||
* 删除缓存
|
||||
* @param string $key 缓存键
|
||||
* @return bool
|
||||
*/
|
||||
private function deleteCache(string $key): bool
|
||||
{
|
||||
return cache($key,null);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,96 @@
|
||||
<?php
|
||||
|
||||
namespace support\OpenImSdk\Core;
|
||||
|
||||
class Url
|
||||
{
|
||||
// 认证管理
|
||||
static $getAdminToken = '/auth/get_admin_token';
|
||||
static $getUserToken = '/auth/get_user_token';
|
||||
static $forceLogout = '/auth/force_logout';
|
||||
static $parseToken = '/auth/parse_token';
|
||||
static $userToken = '/auth/user_token';
|
||||
|
||||
// 用户管理
|
||||
static $userRegister = '/user/user_register';
|
||||
static $getUsers = '/user/get_users';
|
||||
static $getUsersOnlineStatus = '/user/get_users_online_status';
|
||||
static $getUsersOnlineTokenDetail = '/user/get_users_online_token_detail';
|
||||
static $getSubscribeUsersStatus = '/user/get_subscribe_users_status';
|
||||
static $subscribeUsersStatus = '/user/subscribe_users_status';
|
||||
static $setGlobalMsgRecvOpt = '/user/set_global_msg_recv_opt';
|
||||
static $updateUserInfo = '/user/update_user_info';
|
||||
static $searchNotificationAccount = '/user/search_notification_account';
|
||||
static $addNotificationAccount = '/user/add_notification_account';
|
||||
static $updateNotificationAccount = '/user/update_notification_account';
|
||||
static $accountCheck = '/user/account_check';
|
||||
static $getAllUsersUid = '/user/get_all_users_uid';
|
||||
static $getSelfUserInfo = '/user/get_self_user_info';
|
||||
static $getUsersInfo = '/user/get_users_info';
|
||||
|
||||
// 好友管理
|
||||
static $addBlack = '/friend/add_black';
|
||||
static $addFriend = '/friend/add_friend';
|
||||
static $addFriendResponse = '/friend/add_friend_response';
|
||||
static $deleteFriend = '/friend/delete_friend';
|
||||
static $getBlackList = '/friend/get_black_list';
|
||||
static $getFriendApplyList = '/friend/get_friend_apply_list';
|
||||
static $getFriendList = '/friend/get_friend_list';
|
||||
static $getSelfFriendApplyList = '/friend/get_self_friend_apply_list';
|
||||
static $importFriend = '/friend/import_friend';
|
||||
static $isFriend = '/friend/is_friend';
|
||||
static $removeBlack = '/friend/remove_black';
|
||||
static $setFriendRemark = '/friend/set_friend_remark';
|
||||
static $updateFriends = '/friend/update_friends';
|
||||
|
||||
// 群组管理
|
||||
static $createGroup = '/group/create_group';
|
||||
static $joinGroup = '/group/join_group';
|
||||
static $quitGroup = '/group/quit_group';
|
||||
static $getGroupsInfo = '/group/get_groups_info';
|
||||
static $getGroupMemberList = '/group/get_group_member_list';
|
||||
static $getGroupMembersInfo = '/group/get_group_members_info';
|
||||
static $inviteUserToGroup = '/group/invite_user_to_group';
|
||||
static $kickGroupMember = '/group/kick_group_member';
|
||||
static $transferGroupOwner = '/group/transfer_group_owner';
|
||||
static $getJoinedGroupList = '/group/get_joined_group_list';
|
||||
static $dismissGroup = '/group/dismiss_group';
|
||||
static $muteGroupMember = '/group/mute_group_member';
|
||||
static $cancelMuteGroupMember = '/group/cancel_mute_group_member';
|
||||
static $muteGroup = '/group/mute_group';
|
||||
static $cancelMuteGroup = '/group/cancel_mute_group';
|
||||
static $setGroupMemberNickname = '/group/set_group_member_nickname';
|
||||
static $setGroupMemberInfo = '/group/set_group_member_info';
|
||||
static $getGroupMemberUserIDs = '/group/get_group_member_user_i_ds';
|
||||
static $getGroupAllMemberList = '/group/get_group_all_member_list';
|
||||
static $getUserReqGroupApplicationList = '/group/get_user_req_group_applicationList';
|
||||
static $getGroupUsersReqApplicationList = '/group/get_group_users_req_application_list';
|
||||
static $groupApplicationResponse = '/group/group_application_response';
|
||||
|
||||
// 消息管理
|
||||
static $sendMsg = '/msg/send_msg';
|
||||
static $batchSendMsg = '/msg/batch_send_msg';
|
||||
static $clearMsg = '/msg/clear_msg';
|
||||
static $delMsg = '/msg/del_msg';
|
||||
static $manageSendMsg = '/msg/manage_send_msg';
|
||||
static $revokeMessage = '/msg/revoke_msg';
|
||||
static $sendBusinessNotification = '/msg/send_business_notification';
|
||||
static $getAllConversations = '/msg/get_all_conversations';
|
||||
static $getConversation = '/msg/get_conversation';
|
||||
static $getConversations = '/msg/get_conversations';
|
||||
|
||||
// 会话管理
|
||||
static $getOwnerConversation = '/conversation/get_owner_conversation';
|
||||
static $getSortedConversationList = '/conversation/get_sorted_conversation_list';
|
||||
static $setConversations = '/conversation/set_conversations';
|
||||
|
||||
/**
|
||||
* 构建完整的API URL
|
||||
* @param string $path API路径
|
||||
* @return string 完整URL
|
||||
*/
|
||||
public static function buildUrl(string $path): string
|
||||
{
|
||||
return Config::getHost() . $path;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,184 @@
|
||||
<?php
|
||||
|
||||
namespace support\OpenImSdk\Core;
|
||||
|
||||
use GuzzleHttp\Client;
|
||||
use GuzzleHttp\Exception\GuzzleException;
|
||||
use GuzzleHttp\RequestOptions;
|
||||
use support\OpenImSdk\Exception\ValidatorException;
|
||||
|
||||
class Utils
|
||||
{
|
||||
/**
|
||||
* TokenManager实例
|
||||
* @var TokenManager|null
|
||||
*/
|
||||
private static $tokenManager = null;
|
||||
|
||||
/**
|
||||
* 设置TokenManager
|
||||
* @param TokenManager $tokenManager
|
||||
*/
|
||||
public static function setTokenManager(TokenManager $tokenManager)
|
||||
{
|
||||
self::$tokenManager = $tokenManager;
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取TokenManager
|
||||
* @return TokenManager
|
||||
*/
|
||||
public static function getTokenManager(): TokenManager
|
||||
{
|
||||
if (self::$tokenManager === null) {
|
||||
// 默认使用文件缓存
|
||||
self::$tokenManager = new TokenManager();
|
||||
}
|
||||
|
||||
return self::$tokenManager;
|
||||
}
|
||||
|
||||
/**
|
||||
* 生成操作ID
|
||||
* 用于请求追踪
|
||||
* @return string
|
||||
*/
|
||||
public static function generateOperationID(): string
|
||||
{
|
||||
// 生成一个更具唯一性的操作ID
|
||||
return uniqid('openim_', true) . '_' . str_replace('.', '', microtime(true));
|
||||
}
|
||||
|
||||
/**
|
||||
* 发起HTTP请求
|
||||
* @param string $uri 请求URI
|
||||
* @param array $data 请求数据
|
||||
* @param string $token 认证令牌
|
||||
* @return string 响应内容
|
||||
* @throws GuzzleException
|
||||
* @throws ValidatorException
|
||||
*/
|
||||
private static function request(string $uri, array $data, string $token): string
|
||||
{
|
||||
$client = new Client();
|
||||
$options[RequestOptions::JSON] = Validator::validateArray($data);
|
||||
|
||||
// 添加必要的请求头
|
||||
$options[RequestOptions::HEADERS]['operationID'] = self::generateOperationID();
|
||||
|
||||
if ($token) {
|
||||
$options[RequestOptions::HEADERS]['token'] = $token;
|
||||
}
|
||||
|
||||
return $client->post($uri, $options)->getBody()->getContents();
|
||||
}
|
||||
|
||||
/**
|
||||
* 发送API请求
|
||||
* @param string $path API路径
|
||||
* @param array $data 请求数据
|
||||
* @param string $errMsg 错误信息
|
||||
* @param string $token 认证令牌
|
||||
* @return array 响应数据
|
||||
*/
|
||||
public static function send(string $path, array $data, string $errMsg, string $token = ''): array|bool
|
||||
{
|
||||
$url = Url::buildUrl($path);
|
||||
//cp($url);
|
||||
$res = json_decode(self::request($url, $data, $token), true);
|
||||
if($res['errCode'] !==0 ){
|
||||
throw new \Exception($res['errMsg'],$res['errCode']);
|
||||
//throw new \Exception($res['errDlt'],$res['errCode']);
|
||||
}
|
||||
if(isset($res['data'])){
|
||||
return $res['data'];
|
||||
}
|
||||
return true;
|
||||
|
||||
try {
|
||||
$url = Url::buildUrl($path);
|
||||
cp($url);
|
||||
return json_decode(self::request($url, $data, $token), true);
|
||||
} catch (GuzzleException $e) {
|
||||
return ['errCode' => $e->getCode(), 'errMsg' => $errMsg, 'errDlt' => $e->getMessage()];
|
||||
} catch (ValidatorException $e) {
|
||||
return ['errCode' => 400, 'errMsg' => $errMsg, 'errDlt' => $e->getMessage()];
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取管理员Token
|
||||
* 如果缓存中没有,则自动获取并缓存
|
||||
* @param string $userID 管理员ID
|
||||
* @return string|null
|
||||
*/
|
||||
public static function getAdminToken(string $userID = 'imAdmin'): ?string
|
||||
{
|
||||
$tokenManager = self::getTokenManager();
|
||||
$token = $tokenManager->getAdminToken($userID);
|
||||
|
||||
if (!$token) {
|
||||
// 从服务器获取新的Token
|
||||
$result = self::send(Url::$getAdminToken, [
|
||||
'userID' => $userID,
|
||||
'secret' => Config::getSecret()
|
||||
], '获取管理员Token失败');
|
||||
$token = $result['token'];
|
||||
// 使用API返回的过期时间
|
||||
$expireTimeSeconds = $result['expireTimeSeconds'] ?? null;
|
||||
|
||||
// 保存token,使用API返回的过期时间
|
||||
$tokenManager->saveAdminToken($userID, $token, $expireTimeSeconds);
|
||||
|
||||
}
|
||||
|
||||
return $token;
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取用户Token
|
||||
* 如果缓存中没有,则自动获取并缓存
|
||||
* @param string $userID 用户ID
|
||||
* @param int $platformID 平台ID
|
||||
* @return string|null
|
||||
*/
|
||||
public static function getUserToken(string $userID, int $platformID = 1): ?string
|
||||
{
|
||||
$tokenManager = self::getTokenManager();
|
||||
$token = $tokenManager->getUserToken($userID);
|
||||
|
||||
if (!$token) {
|
||||
// 从服务器获取新的Token
|
||||
$adminToken = self::getAdminToken();
|
||||
if (!$adminToken) {
|
||||
return null;
|
||||
}
|
||||
|
||||
$result = self::send(Url::$getUserToken, [
|
||||
'userID' => $userID,
|
||||
'platformID' => $platformID
|
||||
], '获取用户Token失败', $adminToken);
|
||||
|
||||
$token = $result['token'];
|
||||
|
||||
// 使用API返回的过期时间
|
||||
$expireTimeSeconds = $result['expireTimeSeconds'] ?? null;
|
||||
|
||||
// 保存token,使用API返回的过期时间
|
||||
$tokenManager->saveUserToken($userID, $token, $expireTimeSeconds);
|
||||
}
|
||||
|
||||
return $token;
|
||||
}
|
||||
|
||||
/**
|
||||
* 清除Token缓存
|
||||
* @param string $userID 用户ID
|
||||
* @param bool $isAdmin 是否为管理员Token
|
||||
* @return bool
|
||||
*/
|
||||
public static function clearToken(string $userID, bool $isAdmin = false): bool
|
||||
{
|
||||
return self::getTokenManager()->clearToken($userID, $isAdmin);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,91 @@
|
||||
<?php
|
||||
|
||||
namespace support\OpenImSdk\Core;
|
||||
|
||||
use support\OpenImSdk\Exception\ValidatorException;
|
||||
|
||||
class Validator
|
||||
{
|
||||
/**
|
||||
* 验证规则
|
||||
* @var string[]
|
||||
*/
|
||||
private static $rules = [
|
||||
'userID' => 'max:64',
|
||||
'userID1' => 'max:64',
|
||||
'userID2' => 'max:64',
|
||||
'ownerUserID' => 'max:64',
|
||||
'friendUserID' => 'max:64',
|
||||
'blackUserID' => 'max:64',
|
||||
'fromUserID' => 'max:64',
|
||||
'toUserID' => 'max:64',
|
||||
'sendID' => 'max:64',
|
||||
'recvID' => 'max:64',
|
||||
'inviterUserID' => 'max:64',
|
||||
'nickname' => 'max:255',
|
||||
'faceURL' => 'max:255',
|
||||
'gender' => 'in:1,2',
|
||||
'groupID' => 'max:64',
|
||||
'groupName' => 'max:255',
|
||||
'introduction' => 'max:255',
|
||||
'notification' => 'max:255',
|
||||
'groupType' => 'in:0,1,2',
|
||||
'oldOwnerUserID' => 'max:64',
|
||||
'newOwnerUserID' => 'max:64',
|
||||
'conversationID' => 'max:128',
|
||||
'handleResult' => 'in:1,2',
|
||||
];
|
||||
|
||||
/**
|
||||
* 验证数组
|
||||
* @param array $data 要验证的数据
|
||||
* @return array 验证后的数据
|
||||
* @throws ValidatorException
|
||||
*/
|
||||
public static function validateArray(array $data): array
|
||||
{
|
||||
foreach ($data as $field => $value) {
|
||||
foreach (self::$rules as $key => $rules) {
|
||||
if ($field == $key) {
|
||||
$ruleList = explode('|', $rules);
|
||||
foreach ($ruleList as $rule) {
|
||||
$ruleParts = explode(':', $rule);
|
||||
$method = $ruleParts[0];
|
||||
$param = $ruleParts[1] ?? null;
|
||||
self::$method($field, $value, $param);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
return $data;
|
||||
}
|
||||
|
||||
/**
|
||||
* 长度最大验证
|
||||
* @param string $field 字段名
|
||||
* @param mixed $value 字段值
|
||||
* @param int $maxLength 最大长度
|
||||
* @throws ValidatorException
|
||||
*/
|
||||
private static function max(string $field, $value, $maxLength)
|
||||
{
|
||||
if (strlen($value) > (int)$maxLength) {
|
||||
throw new ValidatorException("参数 {$field} 长度不能超过 {$maxLength} 位");
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 枚举值验证
|
||||
* @param string $field 字段名
|
||||
* @param mixed $value 字段值
|
||||
* @param string $allowedValues 允许的值(逗号分隔)
|
||||
* @throws ValidatorException
|
||||
*/
|
||||
private static function in(string $field, $value, $allowedValues)
|
||||
{
|
||||
$allowed = explode(',', $allowedValues);
|
||||
if (!in_array($value, $allowed)) {
|
||||
throw new ValidatorException("参数 {$field} 的值必须是以下之一: {$allowedValues},当前值: {$value}");
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,8 @@
|
||||
<?php
|
||||
|
||||
namespace support\OpenImSdk\Exception;
|
||||
|
||||
class ValidatorException extends \Exception
|
||||
{
|
||||
// 可以在这里添加更多的异常处理逻辑
|
||||
}
|
||||
@@ -0,0 +1,233 @@
|
||||
# OpenIM PHP SDK
|
||||
|
||||
> 基于 [OpenIM](https://github.com/orgs/OpenIMSDK) 的 PHP SDK
|
||||
>
|
||||
> API文档: [https://docs.openim.io/restapi/apis/introduction](https://docs.openim.io/restapi/apis/introduction)
|
||||
|
||||
## 安装
|
||||
|
||||
```bash
|
||||
composer require MrYzYs/OpenImSdk
|
||||
```
|
||||
|
||||
## 配置
|
||||
|
||||
```php
|
||||
$config = [
|
||||
'host' => 'http://127.0.0.1:10002', // OpenIM API地址
|
||||
'secret' => 'openIM123', // OpenIM密钥
|
||||
];
|
||||
```
|
||||
|
||||
## 基本使用
|
||||
|
||||
### 初始化客户端
|
||||
|
||||
```php
|
||||
// 使用文件缓存(默认)
|
||||
$IM = new OpenImSdk\Client($config);
|
||||
|
||||
// 使用Redis缓存 (phpredis)
|
||||
$redis = new Redis();
|
||||
$redis->connect('127.0.0.1', 6379);
|
||||
$IM = new OpenImSdk\Client($config, $redis);
|
||||
|
||||
// 使用Redis缓存 (predis)
|
||||
$redis = new Predis\Client([
|
||||
'scheme' => 'tcp',
|
||||
'host' => '127.0.0.1',
|
||||
'port' => 6379,
|
||||
]);
|
||||
$IM = new OpenImSdk\Client($config, $redis);
|
||||
|
||||
// 指定文件缓存目录
|
||||
$IM = new OpenImSdk\Client($config, null, '/path/to/cache');
|
||||
```
|
||||
|
||||
### 认证管理
|
||||
|
||||
```php
|
||||
// 用户注册
|
||||
$result = $IM->auth->userRegister('user123', '测试用户', 'https://example.com/avatar.jpg');
|
||||
|
||||
// 强制登出
|
||||
$logout = $IM->auth->forceLogout('user123');
|
||||
|
||||
// 解析token
|
||||
$tokenInfo = $IM->auth->parseToken($userToken);
|
||||
```
|
||||
|
||||
### 用户管理
|
||||
|
||||
```php
|
||||
// 获取用户列表
|
||||
$users = $IM->user->getUsers($adminToken);
|
||||
|
||||
// 获取用户在线状态
|
||||
$onlineStatus = $IM->user->getUsersOnlineStatus($adminToken, ['user123', 'user456']);
|
||||
|
||||
// 更新用户信息
|
||||
$updateUser = $IM->user->updateUserInfo($adminToken, 'user123', [
|
||||
'nickname' => '新昵称',
|
||||
'faceURL' => 'https://example.com/new-avatar.jpg'
|
||||
]);
|
||||
```
|
||||
|
||||
### 消息管理
|
||||
|
||||
```php
|
||||
// 发送消息
|
||||
$sendMsg = $IM->message->sendMsg(
|
||||
$adminToken,
|
||||
'admin', // 发送者ID
|
||||
'user123', // 接收者ID
|
||||
'', // 群组ID(单聊时为空)
|
||||
'管理员', // 发送者昵称
|
||||
'https://example.com/admin-avatar.jpg', // 发送者头像
|
||||
1, // 发送者平台ID
|
||||
['text' => '你好,这是一条测试消息'], // 消息内容
|
||||
101, // 消息类型(101为文本消息)
|
||||
1 // 会话类型(1为单聊)
|
||||
);
|
||||
|
||||
// 撤回消息
|
||||
$revokeMsg = $IM->message->revokeMessage(
|
||||
$adminToken,
|
||||
'single_user123', // 会话ID
|
||||
'123456', // 消息seq
|
||||
'user123' // 用户ID
|
||||
);
|
||||
```
|
||||
|
||||
### 会话管理
|
||||
|
||||
```php
|
||||
// 获取用户分页会话列表
|
||||
$conversations = $IM->conversation->getOwnerConversation(
|
||||
$adminToken,
|
||||
'user123', // 用户ID
|
||||
1, // 页码
|
||||
20 // 每页数量
|
||||
);
|
||||
|
||||
// 获取排序的会话列表
|
||||
$sortedConversations = $IM->conversation->getSortedConversationList(
|
||||
$adminToken,
|
||||
'user123' // 用户ID
|
||||
);
|
||||
```
|
||||
|
||||
### 好友管理
|
||||
|
||||
```php
|
||||
// 批量导入好友
|
||||
$importFriend = $IM->friend->importFriend(
|
||||
$adminToken,
|
||||
'user123', // 用户ID
|
||||
['user456', 'user789'] // 好友ID列表
|
||||
);
|
||||
|
||||
// 获取好友列表
|
||||
$friendList = $IM->friend->getFriendList(
|
||||
$adminToken,
|
||||
'user123' // 用户ID
|
||||
);
|
||||
|
||||
// 检查是否为好友
|
||||
$isFriend = $IM->friend->isFriend(
|
||||
$adminToken,
|
||||
'user123', // 用户ID1
|
||||
'user456' // 用户ID2
|
||||
);
|
||||
```
|
||||
|
||||
### 群组管理
|
||||
|
||||
```php
|
||||
// 创建群组
|
||||
$createGroup = $IM->group->createGroup(
|
||||
$adminToken,
|
||||
'user123', // 群主ID
|
||||
[], // 普通成员ID列表
|
||||
[], // 管理员ID列表
|
||||
'测试群组', // 群名称
|
||||
'', // 群ID(可选)
|
||||
'https://example.com/group-avatar.jpg', // 群头像
|
||||
'群简介', // 群简介
|
||||
'群公告' // 群公告
|
||||
);
|
||||
|
||||
// 邀请用户加入群组
|
||||
$inviteToGroup = $IM->group->inviteUserToGroup(
|
||||
$adminToken,
|
||||
'group123', // 群组ID
|
||||
'user123', // 邀请者ID
|
||||
['user456', 'user789'] // 被邀请的用户ID列表
|
||||
);
|
||||
|
||||
// 获取群成员列表
|
||||
$groupMembers = $IM->group->getGroupAllMemberList(
|
||||
$adminToken,
|
||||
'group123', // 群组ID
|
||||
0, // 偏移量
|
||||
100 // 数量
|
||||
);
|
||||
|
||||
// 申请加入群组
|
||||
$joinGroup = $IM->group->joinGroup(
|
||||
$userToken, // 用户token
|
||||
'group123', // 群组ID
|
||||
'我想加入这个群组' // 申请消息
|
||||
);
|
||||
|
||||
// 处理群组申请
|
||||
$handleApplication = $IM->group->groupApplicationResponse(
|
||||
$adminToken,
|
||||
'group123', // 群组ID
|
||||
'user456', // 申请者ID
|
||||
'user123', // 处理者ID
|
||||
1, // 处理结果,1同意,2拒绝
|
||||
'欢迎加入' // 处理消息
|
||||
);
|
||||
|
||||
// 踢出群成员
|
||||
$kickMember = $IM->group->kickGroupMember(
|
||||
$adminToken,
|
||||
'group123', // 群组ID
|
||||
'user123', // 踢出者ID
|
||||
['user456'], // 被踢出的用户ID列表
|
||||
'违反群规' // 踢出原因
|
||||
);
|
||||
|
||||
// 转让群主
|
||||
$transferOwner = $IM->group->transferGroupOwner(
|
||||
$adminToken,
|
||||
'group123', // 群组ID
|
||||
'user123', // 原群主ID
|
||||
'user456' // 新群主ID
|
||||
);
|
||||
```
|
||||
|
||||
## 目录结构
|
||||
|
||||
```
|
||||
src/
|
||||
├── Api/ # API接口类
|
||||
│ ├── Auth.php # 认证相关API
|
||||
│ ├── Conversation.php # 会话相关API
|
||||
│ ├── Friend.php # 好友相关API
|
||||
│ ├── Group.php # 群组相关API
|
||||
│ ├── Message.php # 消息相关API
|
||||
│ └── User.php # 用户相关API
|
||||
├── Core/ # 核心类
|
||||
│ ├── Config.php # 配置类
|
||||
│ ├── TokenManager.php # Token管理类
|
||||
│ ├── Url.php # URL管理
|
||||
│ ├── Utils.php # 工具类
|
||||
│ └── Validator.php # 验证器
|
||||
├── Exception/ # 异常处理
|
||||
│ └── ValidatorException.php # 验证异常
|
||||
└── Client.php # 客户端入口
|
||||
```
|
||||
|
||||
许可协议: GPL-V3
|
||||
@@ -0,0 +1,24 @@
|
||||
{
|
||||
"name": "mryzys/openim-sdk",
|
||||
"description": "OpenIM PHP SDK - A PHP client for OpenIM REST API",
|
||||
"keywords": [
|
||||
"openimsdk", "openim", "im", "chat", "messaging"
|
||||
],
|
||||
"license": "GPL-3.0-only",
|
||||
"authors": [
|
||||
{
|
||||
"name": "mryzys",
|
||||
"email": "mryzys@163.com"
|
||||
}
|
||||
],
|
||||
"require": {
|
||||
"php": "^8.0",
|
||||
"guzzlehttp/guzzle": "^7.5.0",
|
||||
"ext-json": "*"
|
||||
},
|
||||
"autoload": {
|
||||
"psr-4": {
|
||||
"OpenImSdk\\": "src/"
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user