laravel通过事件广播与websocket实现实时通信,1. 配置redis或Pusher驱动并创建实现ShouldBroadcast接口的事件;2. 使用laravel/websockets扩展启动WebSocket服务器;3. 前端引入Laravel echo连接本地WebSocket并监听事件;4. 解决CORS、端口、路由等常见问题,最终无需第三方服务即可构建实时应用。

在使用 Laravel 开发实时应用时,核心通信机制依赖于事件广播(Event Broadcasting)和 WebSocket 技术。Laravel 本身不直接处理长连接,但通过集成 Laravel Echo、Pusher、Redis 和 Laravel WebSockets 等工具,可以实现高效的实时通信。
1. Laravel 事件广播机制
Laravel 允许将服务器端触发的事件“广播”到客户端,前端通过 javaScript 监听这些事件并更新界面。要启用广播功能:
- 在 .env 文件中设置广播驱动:
BROADCAST_DRIVER=redis - 确保 config/broadcasting.php 配置正确,选择 Redis 或 Pusher 作为驱动
- 在 App/Providers/BroadcastServiceProvider.php 中取消对广播路由的注释
定义一个可广播的事件类:
php artisan make:event MessageSent
在事件类中实现 ShouldBroadcast 接口:
立即学习“PHP免费学习笔记(深入)”;
class MessageSent implements ShouldBroadcast { public $message; public function __construct($message) { $this->message = $message; } public function broadcastOn() { return new Channel('chat'); } }
2. 使用 Laravel WebSockets 扩展包
由于浏览器不支持原生的 Redis 协议,需要一个 WebSocket 服务器来桥接。推荐使用 laravel/websockets 包:
- 安装扩展包:
composer require beyondcode/laravel-websockets - 发布配置文件:
php artisan vendor:publish --provider="BeyondCodeLaravelWebSocketsWebSocketsServiceProvider" - 启动 WebSocket 服务:
php artisan websockets:serve
该命令会启动一个运行在 6001 端口的 WebSocket 服务器,接收来自客户端的连接。
3. 前端使用 Laravel Echo 连接
Laravel Echo 是一个 javascript 库,用于简化对 WebSocket 和事件的监听。
- 引入 Laravel Echo 和 Pusher js 库(即使使用 laravel-websockets,也兼容 Pusher 协议)
- 初始化 Echo 实例:
import Echo from "laravel-echo"; window.Pusher = require('pusher-js'); window.Echo = new Echo({ broadcaster: 'pusher', key: 'your-pusher-key', wsHost: window.location.hostname, wsPort: 6001, forceTLS: false, disableStats: true, encrypted: false }); // 监听事件 Echo.channel('chat') .listen('MessageSent', (e) => { console.log(e.message); });
4. 配置与调试建议
开发过程中常见问题及解决方案:
- CORS 问题:确保 WebSocket 服务允许当前域名访问,在 config/websockets.php 中配置 allowed_origins
- 跨域或连接失败:检查防火墙是否开放 6001 端口,前端连接地址是否正确
- 事件未触发:确认事件类实现了 ShouldBroadcast,且已正确分发(event(new MessageSent($msg)))
- 生产环境部署:建议使用 swoole 或 nginx 反向代理 WebSocket 服务,提升性能和安全性
基本上就这些。Laravel 搭配 laravel-websockets 提供了一套完整的 PHP 实时通信方案,无需依赖第三方服务即可实现聊天、通知、协作等功能。


