Gateway::bindUid
说明:
void Gateway::bindUid(string $client_id, mixed $uid);
将 client_id 与 uid 绑定,以便通过 Gateway::sendToUid($uid)
发送数据,通过 Gateway::isUidOnline($uid)
用户是否在线。
uid 解释:这里 uid 泛指用户 id 或者设备 id,用来唯一确定一个客户端用户或者设备。
注意:
1、uid 与 client_id 是一对多的关系,系统允许一个 uid 下有多个 client_id。
2、但是一个 client_id 只能绑定一个 uid,如果绑定多次 uid,则只有最后一次绑定有效。
2、如果业务需要一对一的关系,可以通过 Gateway::getClientIdByUid($uid)
获得某 uid 已经绑定的所有 client_id,然后调用 closeClient($client_id)
踢掉之前的 client_id。
3、client_id 下线(连接断开)时会自动执行解绑,开发者无需调用 Gateway::unbindUid 解绑。
4、如果某个 uid 对应的所有 client_id 都下线了,则调用 Gateway::isUidOnline($uid)
将返回 0,即 uid 不在线。
5、uid 和 client_id 映射关系存储在 Gateway 进程内存中。
6、调用 Gateway::bindUid($client_id, $uid)
的时机一般是在验证连接合法性的时候。例如客户端连上服务端后,发送的第一个数据包应当包含客户端的鉴权信息 (例如用户名密码或者可用于鉴权的 token),服务端通过鉴权信息确定该连接属于哪个 uid,然后调用 Gateway::bindUid($client_id, $uid)
绑定。
参数
$client_id
客户端的 client_id
$uid
uid, 可以是数字或者字符串。
返回值
无返回值
范例
use \GatewayWorker\Lib\Gateway;
class Events
{
...
public static function onMessage($client_id, $message)
{
// $message = '{"type":"login","uid":"xxxxx"}'
$req_data = json_decode($message, true);
Gateway::bindUid($client_id, $req_data['uid']);
}
...
}