# 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']); } ... } ~~~