Laravel使用Pusher时如何获取Presence通道的全部已连接用户
Pusher Presence通道在线用户拉取的落地实现方案
常见报错与疑惑的根因说明
1. 静态调用get()方法报错的本质
你遇到的Non-static method Pusher\Pusher::get() should not be called statically错误,核心是混淆了不同层级的类:
- 你直接引用的
Pusher\Pusher类是官方底层SDK的核心类,它的所有接口调用方法(包括get())都是绑定在实例上的,本身没有static修饰,直接静态调用必然触发PHP语法报错。 - 网上旧教程提到的
Pusher::get()静态写法,要么是基于v2及更早版本的SDK(当时做了静态方法封装),要么是指框架提供的静态门面:如果是Laravel这类带门面机制的框架,合法的静态写法需要调用框架提供的Pusher门面类,门面内部会自动把静态请求转发到容器内的已初始化实例上,不会触发非静态调用的报错,不要直接拿底层SDK类做静态调用。
2. $this->pusher实例的正确来源
你看到的$this->pusher('/channels')写法,不是框架给控制器内置的原生属性,是开发者自定义的依赖注入结果:
- 框架服务容器在初始化阶段,已经按照你配置的APP ID、密钥、集群等参数,实例化好了可直接使用的Pusher单例对象。
- 开发者通常会在控制器的构造函数里,把这个容器中的实例注入为控制器类的成员变量,后续控制器方法里就能直接通过
$this->pusher调用,本质上还是走的实例方法调用逻辑,不是特殊的语法糖。
完整实现流程
- 第一步:从服务容器解析已配置完成的Pusher实例,不要自己重复写参数初始化新的实例,避免配置不一致。比如在Laravel场景下,通过
$pusher = app(\Pusher\Pusher::class)即可拿到合法的可用实例。 - 第二步:分步骤拉取Presence通道的用户数据:
- 先调用实例方法
$pusher->get('/channels', ['filter_by_type' => 'presence']),拿到当前所有活跃的Presence通道列表,过滤掉普通的公开、私有通道。 - 遍历每个Presence通道,注意通道名需要加上
presence.的固定前缀,调用$pusher->get('/channels/presence.'.$channelName.'/users')即可拿到每个通道下的所有已连接用户信息,返回结果包含用户id、连接时携带的自定义用户元数据等内容。
- 先调用实例方法
- 第三步:将拉取到的用户信息写入数据库时,要以「通道名+用户id」为唯一键做幂等处理:如果记录已存在则更新用户最后活跃时间,不存在则新增,不要直接清空旧表全量覆盖写入,避免误删正在连接的有效用户记录。
落地注意事项
- 拉取在线用户的Pusher API接口存在请求频次限制,建议配合定时任务(间隔1-2分钟)拉取数据,不要在用户请求的同步链路里直接调用,避免拖慢接口响应。
- 数据库里的在线用户记录清理,不要只靠定时拉取的差集做删除,最好配合Pusher的连接断开Webhook,在用户离线的第一时间触发记录状态更新,减少数据和实际在线状态的延迟。
内容的提问来源于stack exchange,提问作者Thomas Timmermans
相关产品推荐
相关产品推荐

