信息发布→ 登录 注册 退出

laravel Reverb如何实现实时WebSocket通信_Laravel Reverb实时WebSocket通信教程

发布时间:2025-09-29

点击量:
首先安装并配置 Laravel Reverb 扩展包,通过 Composer 安装后发布配置文件并运行迁移;接着在 .env 中设置 Redis 为广播驱动,确保 broadcasting 配置正确;然后创建实现 ShouldBroadcast 的事件类,定义频道及授权逻辑,并在控制器触发事件;前端使用 Laravel Echo 连接 Reverb 服务,监听公共或私有频道事件;最后启动 Reverb 服务(php artisan reverb:start),建议生产环境用 Supervisor 管理进程;注意配置 CORS、权限验证及日志调试。

Laravel Reverb 是 Laravel 官方推出的轻量级 WebSocket 服务,专为实现实时通信设计。它与 Laravel Echo 配合使用,能轻松实现聊天、通知推送、在线状态更新等实时功能。下面带你一步步搭建基于 Laravel Reverb 的 WebSocket 通信系统。

安装与配置 Laravel Reverb

Reverb 目前作为 Laravel 的官方扩展包,支持 Laravel 10+ 版本。先通过 Composer 安装:

composer require laravel/reverb

发布配置文件和迁移表:

php artisan vendor:publish --provider="Laravel\Reverb\ReverbServiceProvider"

这会生成 config/reverb.php 和数据库迁移文件。运行迁移创建必要的数据表:

php artisan migrate

接下来配置环境变量。在 .env 文件中设置 Redis 作为广播驱动(推荐):

BROADCAST_DRIVER=redis
REDIS_CLIENT=predis

确保 config/broadcasting.php 中的 Redis 连接配置正确。

启用广播事件与频道授权

Laravel Reverb 基于广播系统工作。你需要定义广播事件并指定其频道。例如创建一个新消息通知事件:

php artisan make:event MessageSent

编辑该事件类,使其实现 ShouldBroadcast 接口:

class MessageSent implements ShouldBroadcast
{
    public $message;

    public function __construct($message)
    {
        $this->message = $message;
    }

    public function broadcastOn()
    {
        return new Channel('chat');
    }
}

如果使用私有频道,需定义授权逻辑。在 routes/channels.php 中添加:

Broadcast::channel('chat', function ($user) {
    return $user ? true : false;
});

然后在控制器中触发事件:

event(new MessageSent('Hello World'));

前端连接 WebSocket 并监听事件

前端使用 Laravel Echo 连接 Reverb 提供的 WebSocket 服务。先安装依赖:

npm install --save laravel-echo @socket.io/socket.io-client

resources/js/bootstrap.js 或主 JS 文件中初始化 Echo:

import { Echo } from 'laravel-echo';

window.io = require('socket.io-client');

window.Echo = new Echo({
    broadcaster: 'socket.io',
    host: window.location.hostname + ':8080', // Reverb 默认端口
    scheme: 'http',
    csrfToken: document.querySelector('meta[name="csrf-token"]').getAttribute('content')
});

监听公共频道事件:

Echo.channel('chat')
    .listen('MessageSent', (e) => {
        console.log(e.message);
    });

若监听私有频道,使用 private() 方法并确保用户已登录:

Echo.private('chat')
    .listen('MessageSent', (e) => {
        console.log('Private:', e.message);
    });

启动 Reverb WebSocket 服务

开发环境下,使用 Artisan 命令启动 Reverb 服务:

php artisan reverb:start

默认监听 8080 端口。你可在 config/reverb.php 中修改主机、端口、SSL 设置等。

生产环境建议使用 Supervisor 管理进程,并配合 Nginx 反向代理处理 SSL 和负载均衡。

基本上就这些。只要广播配置正确,前后端连接顺畅,Laravel Reverb 就能稳定运行 WebSocket 通信。注意开启跨域(CORS)和权限验证,避免安全问题。整个流程不复杂但容易忽略细节,比如 Redis 驱动、频道授权或端口占用。调试时多看日志:storage/logs/laravel.log 和浏览器控制台信息都很关键。

标签:# php  # laravel  # redis  # js  # 前端  # bootstrap  # composer  # nginx  # 浏览器  # 端口  # echo  # 接口  # private  
在线客服
服务热线

服务热线

4008888355

微信咨询
二维码
返回顶部
×二维码

截屏,微信识别二维码

打开微信

微信号已复制,请打开微信添加咨询详情!