Server->getClientList
最后更新于：2022-04-02 06:20:36
# Server->getClientList
用来遍历当前`Server`所有的客户端连接，`Server::getClientList`方法是基于共享内存的，不存在`IOWait`，遍历的速度很快。另外`getClientList`会返回所有`TCP`连接，而不仅仅是当前`Worker`进程的`TCP`连接。
> 推荐使用[Server::$connections](Serverconnections.md)迭代器来遍历连接`getClientList`的别名是`connection_list`
> `getClientList`仅可用于`TCP`客户端，`UDP`服务器需要自行保存客户端信息
> `SWOOLE_BASE`模式下只能获取当前进程的连接
函数原型：
~~~
Server::getClientList(int $start_fd = 0, int $pagesize = 10);
~~~
此函数接受`2`个参数，第`1`个参数是起始`fd`，第`2`个参数是每页取多少条，最大不得超过`100`。
* 调用成功将返回一个数字索引数组，元素是取到的`$fd`。数组会按从小到大排序。最后一个`$fd`作为新的`start_fd`再次尝试获取
* 调用失败返回`false`
示例：
~~~
$start_fd = 0;
while(true)
{
$conn_list = $serv->getClientList($start_fd, 10);
if ($conn_list===false or count($conn_list) === 0)
{
echo "finish\n";
break;
}
$start_fd = end($conn_list);
var_dump($conn_list);
foreach($conn_list as $fd)
{
$serv->send($fd, "broadcast");
}
}
~~~
';