Skip to content

Gateway::sendToUid

说明:

php
void Gateway::sendToUid(mixed $uid, string $message);

向 uid 绑定的所有在线 client_id 发送数据。

注意:默认 uid 与 client_id 是一对多的关系,如果当前 uid 下绑定了多个 client_id,则多个 client_id 对应的客户端都会收到消息,这类似于 PC QQ 和手机 QQ 同时在线接收消息。

参数

  • $uid

uid 可以是字符串、数字、或者包含 uid 的数组。如果为数组,则是给数组内所有 uid 发送数据

  • $message

要发送的数据(字符串类型),此数据会被 Gateway 所使用协议的 encode 方法打包后再发送给客户端

返回值

因为数据发送是异步进行的,所以没有返回值。一般来说只要 uid 在线就可以发送成功。

发送前先可以用 Gateway::getClientIdByUid 判断下 uid 是否有在线的 client_id。

范例

php
use \GatewayWorker\Lib\Gateway;
class Events
{
    ...

    public static function onMessage($client_id, $message)
    {
        // $message = '{"type":"send_to_uid","uid":"xxxxx", "message":"...."}'
        $req_data = json_decode($message, true);
        Gateway::sendToUid($req_data['uid'], $req_data['message']);
    }

    ...
}

基于 MIT 许可发布