\GatewayWorker\Lib\Gateway::bindUid

说明:

  1. 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,可以是数字或者字符串。

范例

  1. use \GatewayWorker\Lib\Gateway;
  2. class Events
  3. {
  4.     ...
  6.     public static function onMessage($client_id, $message)
  7.     {
  8.         // $message = '{"type":"login","uid":"xxxxx"}'
  9.         $req_data = json_decode($message, true);
  10.         Gateway::bindUid($client_id, $req_data['uid']);
  11.     }
  13.     ...
  14. }