Gateway::ungroup

说明:

void Gateway::ungroup(mixed $group);

(要求Gateway版本>=3.0.9) 如何查看Gateway版本

取消分组,或者说解散分组。
取消分组后所有属于这个分组的用户的连接将被移出分组,此分组将不再存在,除非再次调用Gateway::joinGroup($client_id, $group)将连接加入分组。

注意:
1、调用Gateway::ungroup($group) 相当于以下代码,

$client_id_list = Gateway::getClientIdListByGroup($group);
foreach($client_id_list as $client_id) {
    Gateway::leaveGroup($client_id, $group);
}

区别是Gateway::ungroup($group)性能要好很多。

2、调用Gateway::ungroup($group)后,仍然可以调用Gateway::joinGroup($client_id, $group)将某个连接加入这个分组。

参数

  • $group

只能是数字或者字符串。

返回值

无返回值

范例

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

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

    ...
}
编辑于2024-03-13 17:37:33 完善本页 +发起讨论
赞助商
×