# Gateway::getAllGroupIdList ## 说明: ```php array Gateway::getAllGroupIdList(void); ``` ``` (要求Gateway版本>=3.0.8) ``` [如何查看Gateway版本](get-gateway-version.md) 获取全局所有在线group id列表。 ## 返回值 返回group id为key同时group id为值的数组。 类似下面的格式 ```php array( 'room-1' => 'room-1', 'room-2' => 'room-2' ) ``` 注意:如果是客户端断网断电等极端情况掉线,客户端的onClose回调可能无法及时触发,参见[onClose](on-close.md)说明。也就是说对应客户端出现断网断电等极端掉线情况返回值中可能包含了不准确的数据。这种情况需要[心跳来检测](heartbeat.md)已经掉线的客户端。 ## 范例 ```php use \GatewayWorker\Lib\Gateway; class Events { ... public onMessage($client_id, $message) { $group = 'room-1'; Gateway::joinGroup($client_id, $group); var_export(Gateway::getAllGroupIdList()); } ... } ``` 打印出的数据类似如下: ```php array( 'room-1' => 'room-1', 'room-2' => 'room-2' ) ```