(踩坑记录)使用 Laravel-echo-server 构建实时应用

在我看来,实时通信才是 APP 应用的将来。 Socket 服务通常不是那么容易实现,但是 Laravel Echo 服务改变了这个情况。

在本文中,我将会简要的介绍如何建立一个可以运行的 Socket 服务并且在这个服务上进行事件的广播。(https://github.com/tlaverdure/laravel-echo…, Laravel 的支持文档:https://learnku.com/docs/laravel/5.6/broadcasting#…)

它是完全免费的,你只要运行你自己的 Socket 服务。你也可以使用 Laravel 默认集成的 Pusher ,唯一的缺点是它是有限制的,如果超出限制则需要付费。我更喜欢自己来架构这些东西。

要求:

Laravel 框架 (本教程使用了 5.6 版本)

Redis 服务

基本的 Laravel 知识

安装 laravel-echo-server

首先我们需要全局安装 laravel-echo-server , 你只需在终端输入下面的命令。

$ npm install -g laravel-echo-server

安装完成后,打开你的 Laravel 应用,或者新启一个测试项目:

$ composer create-project --prefer-dist laravel/laravel echo-test

接下来为我们的应用安装 Predis :

$ composer require predis/predis

安装完成后,切换到项目根目录下,初始化 Socket 服务:

$ laravel-echo-server init

执行这条命令后,会询问你一些关于 Socket 服务的配置信息,你可以根据自己的情况填写:

切记在生产环境中,无论你什么时候使用它,都应该关掉你的开发者模式。

我们可以尝试启动服务,看看它是否正常运行:

$ laravel-echo-server start

输出结果看起来像这样:

配置 Laravel 使 Laravel Echo Server 正常工作

打开你的config/app.php文件并且取消BroadcastServiceProvider在这个 Providers 数组中的注释:

App\Providers\BroadcastServiceProvider::class,

这个 Provider 将会启动广播路由(你或许已经在routes/channels.php文件里面已经看到了)

打开.env文件,修改BROADCAST_DRIVER的值为你在 laravel-echo-server 初始化时定义的值(Redis 或者 Log)。在本教程中我们将使用 Redis 驱动程序。

同时修改QUEUE_DRIVER为你喜欢的任何队列驱动程序,在这个示例中你可以轻松的将其更改为 Redis 驱动程序,因为你在前面已经安装并且在运行了。

接下来我们必须安装 Socket.io 客户端和 Laravel-Echo 包,你可以通过以下操作来安装:

$ npm install --save socket.io-client

$ npm install --save laravel-echo

(在运行这个之前你可能需要运行npm install来安装 Laravel 及相关依赖)

接下来打开resources/assets/js/bootstrap.js文件, 或者你自己的 引入所有 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 + ':6001'});

现在我们准备在频道上监听消息了!我会在本教程中解释怎么开放频道,接下来开始收听我们的第一个频道:

window.Echo.channel('test-event')    .listen('ExampleEvent', (e) => {        console.log(e);    });

我们通过 JS 代码告诉程序我们订阅了名为 ’test-event’ 的频道,并监听 ‘ExampleEvent’ 事件 (这是事件的类名,你也可以根据你的需要自定义)。

让我们创建这个事件类:

$ php artisan make:event ExampleEvent

这将会在App/Events目录下面创建一个叫做ExampleEvent.php的事件类

让我们对这个事件类稍作调整使得它能够在我们的 Socket 服务 中能够正常运行,首先确保你的事件类继承于ShouldBroadcast接口,就像下面这样;

class ExampleEvent implements ShouldBroadcast

接下来向下滚动找到broadcastOn函数,修改它使得我们能够在正确的频道上进行广播:

public function broadcastOn(){    return new Channel('test-event');}

让我们在下面新建一个函数,这样我们才能有一些实例数据:

public function broadcastWith(){    return [        'data' => 'key'    ];}

这个函数在事件被调用时调用,它将会把数据返回到你的 Socket 服务中。

现在让我们开始尝试它吧!打开你的routes/web.php文件并且新增一个测试路由:

Route::get('test-broadcast', function(){    broadcast(new \App\Events\ExampleEvent);});

(有很多种方式来广播ExampleEvent类 ,在这个示例中我使用 Laravel 提供的broadcast()助手,在我看来这是最简洁的方式)

启动队列监听:

$ php artisan queue:listen --tries=1

浏览器打开一个包含 JS 文件的页面(可以是 Laravel 默认的欢迎页面),这是第一个页面,请不要关闭次页面,我们已经在此页面上订阅了 Socket 服务。

接下来打开另一个页面访问/test-broadcast,这将会返回一个空白页面,但是它将会通过你的ExampleEvent类广播到你的 Socket 服务上。返回到我们的第一个页面,打开浏览器控制台,应该可以看到类似信息:

正如你所看到的,数据通过这种形式展示在我们的客户端。你能输入任意数据通过你的ExampleEvent类来广播他们,这些数据可以是新闻更新,页面更新,总浏览量或者更多。

因为我们有在 laravel-echo-server 配置中有设置开发者模式,所以你能看到 Socket 服务上的所有基本信息:

现在你已经安装并运行了一个基本的 Socket 服务!但这并不是全部,你可以根据这个来做更多的事情,比如为单个用户提供认证的私有渠道。(当您想广播订单更新或私人消息时)

要做到这一点,我建议你去查看 Laravel 文档了解更多相关的内容。通过这个主题你能做很多事情,让你的应用程序变得更加神奇。你可以在这里找到相应的文档:

Broadcasting – Laravel – The PHP framework for web artisans.laravel.com

其他: 在生产环境中运行

正如我之前所说,你必须在laravel-echo-server.json配置文件中禁用开发者模式。 当然在服务器上你可以忽略这个文件,重新初始化它,因为你的主机可能和本地不同。

你还需要保持你的 Socket 服务在你的生产环境中运行,你可以用 Supervisor ,但是我通常使用PM2 ,它可以方便快速的管理你的服务。(http://pm2.keymetrics.io/)

这里是我使用PM2的 Socket.sh 基本配置:

#!/usr/bin/env bashlaravel-echo-server  start

安装了PM2后, 你可以通过pm2 start socket.sh命令来启动脚本,运行你的 Socket 服务。

我希望它能够帮助到你。 这篇文章主要介绍的是一些基础知识,接下来我们会继续讨论广播路由的授权和不同的广播频道。

本篇文章转载自:https://www.silingsi.com/archives/303

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 202,802评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,109评论 2 379
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 149,683评论 0 335
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,458评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,452评论 5 364
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,505评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,901评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,550评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,763评论 1 296
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,556评论 2 319
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,629评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,330评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,898评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,897评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,140评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,807评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,339评论 2 342

推荐阅读更多精彩内容