0

0

Laravel与React实时通知:使用Pusher实现高效前后端通信

碧海醫心

碧海醫心

发布时间:2025-10-11 09:50:23

|

566人浏览过

|

来源于php中文网

原创

laravel与react实时通知:使用pusher实现高效前后端通信

本文旨在解决Laravel后端向React前端发送实时通知的问题,特别是当传统Service Worker的push事件监听遇到限制时。我们将详细介绍如何利用Pusher这一实时通信库,在Laravel中配置事件广播,并在React应用中订阅并处理这些实时通知,从而实现高效、可靠的前后端实时数据同步。

理解实时通知的挑战

在现代Web应用中,实时通知是提升用户体验的关键功能之一。当后端发生数据更新或特定事件时,前端需要立即收到反馈。直接的HTTP请求-响应模式无法满足这种实时性需求。对于浏览器推送通知(Web Push Notifications),虽然Service Worker的self.addEventListener('push')事件可以监听来自服务器的推送,但它通常需要复杂的VAPID密钥配置、用户授权管理,并且主要用于在浏览器未激活时向用户发送系统级通知。对于应用内部的实时数据更新或通知,采用专门的实时通信库(如Pusher)往往更为高效和灵活。

原始问题中遇到的Unexpected use of 'self' no restricted-globals错误,通常发生在Service Worker脚本中尝试访问非Service Worker全局对象时,或者是在不正确的上下文中使用self。更重要的是,即使解决了这个语法问题,Laravel的Notification::send方法默认情况下并不直接触发Web Push API的push事件,它需要与特定的Web Push通知通道配合使用。对于更通用的实时事件广播,Pusher提供了更简洁的解决方案。

引入Pusher:实时通信解决方案

Pusher是一个托管的实时API服务,它允许开发者轻松地将实时功能集成到Web、移动和IoT应用中。它通过WebSocket技术在客户端和服务器之间建立持久连接,实现低延迟的双向通信。Laravel内置了对Pusher的支持,使其成为实现实时事件广播的理想选择。

Laravel后端配置

要在Laravel应用中集成Pusher,你需要完成以下步骤:

1. 安装Pusher依赖

首先,通过Composer安装Pusher PHP SDK:

composer require pusher/pusher-php-server

2. 配置广播驱动

Laravel使用广播(Broadcasting)来发送事件。你需要将广播驱动配置为pusher。 在你的.env文件中,添加Pusher的凭据:

BROADCAST_DRIVER=pusher
PUSHER_APP_ID=your-pusher-app-id
PUSHER_APP_KEY=your-pusher-app-key
PUSHER_APP_SECRET=your-pusher-app-secret
PUSHER_APP_CLUSTER=your-pusher-app-cluster # 例如:ap2, mt1, eu

这些凭据可以在Pusher仪表盘中创建和获取。 确保在config/app.php中取消注释App\Providers\BroadcastServiceProvider::class,以便启用广播服务提供者。

3. 定义可广播事件

创建一个新的事件,并实现ShouldBroadcast接口。这将告诉Laravel该事件应该被广播。

// app/Events/NewNotification.php
title = $title;
        $this->message = $message;
        $this->icon = $icon;
    }

    /**
     * Get the channels the event should broadcast on.
     *
     * @return array
     */
    public function broadcastOn(): array
    {
        // 广播到一个公共频道
        return [new Channel('notifyChannel')];
    }

    /**
     * The event's broadcast name.
     *
     * @return string
     */
    public function broadcastAs()
    {
        return 'notifyEvent'; // 事件的名称,前端将通过这个名称监听
    }
}

在上面的例子中,broadcastOn()方法定义了事件将广播到的频道(notifyChannel),broadcastAs()方法定义了事件的名称(notifyEvent)。

4. 在控制器中触发事件

你可以在任何需要发送通知的地方(例如控制器、服务或模型)触发这个事件。

// app/Http/Controllers/PushController.php
json(['status' => 'Notification sent!']);
    }

    // ... 你的其他方法,例如store
}

当sendNotification方法被调用时,NewNotification事件会被触发并通过Pusher广播到notifyChannel频道。

React前端集成

在React应用中,你需要安装Pusher JavaScript客户端库并监听相应的频道和事件。

绘蛙AI修图
绘蛙AI修图

绘蛙平台AI修图工具,支持手脚修复、商品重绘、AI扩图、AI换色

下载

1. 安装Pusher JS客户端库

npm install --save pusher-js
# 或者
yarn add pusher-js

2. 在React组件中监听通知

在你的React组件中,使用useEffect钩子来初始化Pusher连接并订阅频道。

// src/components/NotificationListener.js 或你的主要App.js
import React, { useEffect } from 'react';
import Pusher from 'pusher-js';

const NotificationListener = () => {
  useEffect(() => {
    // 确保在组件挂载时只执行一次
    const pusher = new Pusher(process.env.REACT_APP_PUSHER_APP_KEY, {
      cluster: process.env.REACT_APP_PUSHER_APP_CLUSTER,
      encrypted: true, // 建议使用加密连接
    });

    const channel = pusher.subscribe('notifyChannel'); // 订阅与Laravel中定义的频道相同的频道

    // 绑定到Laravel中定义的事件名称
    channel.bind('notifyEvent', function (data) {
      console.log('收到实时通知:', data);
      // 在这里处理收到的通知数据
      // 例如,显示一个浏览器通知,或者更新UI
      alert(`新通知: ${data.title} - ${data.message}`);

      // 如果需要显示Web Push API风格的浏览器通知,可以在这里调用
      if (Notification.permission === 'granted') {
        navigator.serviceWorker.ready.then(registration => {
          registration.showNotification(data.title, {
            body: data.message,
            icon: data.icon,
            // actions: data.actions // 如果需要,可以添加通知操作
          });
        });
      }
    });

    // 清理函数:在组件卸载时取消订阅
    return () => {
      pusher.unsubscribe('notifyChannel');
      pusher.disconnect();
    };
  }, []); // 空数组表示只在组件挂载和卸载时执行

  return (
    
{/* 你的React应用的其他内容 */}

正在监听实时通知...

); }; export default NotificationListener;

注意事项:

  • process.env.REACT_APP_PUSHER_APP_KEY和process.env.REACT_APP_PUSHER_APP_CLUSTER应该在你的React项目根目录的.env文件中定义,例如:
    REACT_APP_PUSHER_APP_KEY=your-pusher-app-key
    REACT_APP_PUSHER_APP_CLUSTER=your-pusher-app-cluster

    请确保这些环境变量以REACT_APP_开头,以便Create React App能够正确识别它们。

  • channel.bind('notifyEvent', ...)中的notifyEvent必须与Laravel事件中broadcastAs()方法返回的名称一致。
  • 在实际应用中,你可能不会直接使用alert,而是更新Redux store、Context API或组件状态来显示更美观的通知UI,或者触发一个桌面通知。

关于原始问题的解析:Web Push API与实时广播的区别

原始问题中的Laravel代码片段使用了Notification::send($users, new PushDemo),这通常与Laravel的通知系统结合使用。如果PushDemo通知类配置了WebPushChannel,它确实可以用于发送Web Push通知。同时,React中的self.addEventListener('push')是Service Worker用于监听Web Push API事件的标准方式。

然而,Pusher提供的实时广播机制与Web Push API是不同的。

  • Web Push API:主要用于在浏览器未激活或后台运行时向用户发送系统级通知。它依赖于Service Worker和浏览器厂商的推送服务(如FCM、APNS)。用户需要明确授权,并且通知的发送通常受到浏览器策略的限制。
  • Pusher实时广播:通过WebSocket在浏览器(或应用)激活时提供实时的、应用内部的数据更新和通知。它不依赖于Service Worker的push事件,而是通过Pusher客户端库直接管理WebSocket连接。

因此,当你希望在React应用内部实现实时的事件驱动更新时,Pusher是一个更直接、更易于管理的解决方案。如果你仍然需要实现系统级的浏览器推送通知,那么你需要同时配置Laravel的Web Push通知通道,并确保Service Worker正确注册和监听push事件。但对于大多数应用内部的实时通知场景,Pusher的实时广播功能已足够。

注意事项与最佳实践

  1. 安全性:对于敏感数据,考虑使用Pusher的私有频道(Private Channels)。私有频道需要后端进行授权验证,确保只有授权用户才能订阅。
  2. 错误处理:在Pusher客户端代码中添加错误处理逻辑,例如连接失败、订阅失败等。
  3. 用户体验:不要过度发送通知,以免打扰用户。提供用户管理通知偏好的选项。
  4. 替代方案
    • Laravel Echo:Laravel官方提供的JavaScript库,与Pusher(或Redis/Socket.io)无缝集成,简化了事件监听。
    • WebSockets直接实现:如果你需要完全控制,可以自己实现WebSocket服务器(例如使用Node.js的Socket.io或Ratchet),但会增加开发和维护成本。
  5. Pusher Keys的管理:将Pusher的APP_KEY和CLUSTER作为环境变量存储,避免直接硬编码到代码中,特别是在前端代码中,因为前端代码是公开的。
  6. Service Worker与Pusher的结合:如果你既需要应用内实时通知(通过Pusher),又需要离线或浏览器关闭时的系统级通知(通过Web Push API),它们可以并行存在。Pusher负责实时数据流,Service Worker负责处理Web Push通知。

总结

通过Pusher,Laravel和React应用可以轻松实现强大的实时通知功能。Laravel负责事件的广播,而React负责订阅和展示这些事件。这种方法不仅解决了传统Service Worker在特定场景下的限制,还提供了一个健壮、可扩展的实时通信架构,极大地提升了用户体验。理解Web Push API与Pusher实时广播的区别,将帮助你选择最适合你应用场景的解决方案。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

1936

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1275

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1178

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

948

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1400

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1229

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1439

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1303

2023.11.13

vlookup函数使用大全
vlookup函数使用大全

本专题整合了vlookup函数相关 教程,阅读专题下面的文章了解更多详细内容。

26

2025.12.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 8.1万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 6.9万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号