README

注意！可能与现实情况存在差异。

1. 此包从 "LaraComponents" 分支出来，以适应新的 Centrifugo v2。
2. 删除 Redis 支持（v2 不支持），请参阅官方 迁移指南。
3. 更新 generateToken(user id, timestamp, info) 方法（v2 仅使用 jwt 身份验证工作流程）。

简介

Centrifuge 广播器适用于 laravel >= 5.7 和 Lumen >= 7.0（已测试 Laravel 5.6、7.0 和 Lumen 7.0）

要求

• PHP 7.1.3+ 或更高版本（在 7.2.10 上进行测试）
• Laravel 5.3+ 或更高版本（在 5.7.8 上进行测试）
• Lumen 7.0+ 或更高版本（在 7.2.0 上进行测试）
• Centrifugo 服务器 2 或更高版本（请参阅 此处）

安装

使用 composer 需要此包

composer require LuisOzParr/centrifuge-broadcaster

打开您的 config/app.php 并将以下内容添加到 providers 数组中

'providers' => [
    // ...
    LaraComponents\Centrifuge\CentrifugeServiceProvider::class,

    // And uncomment BroadcastServiceProvider
    App\Providers\BroadcastServiceProvider::class,
],

打开您的 config/broadcasting.php 并将以下内容添加到其中

'connections' => [
    'centrifuge' => [
        'driver'       => 'centrifuge',
        'url'          => env('CENTRIFUGE_URL', 'http://127.0.0.1:8000'),
        'token_ttl'    => env('CENTRIFUGE_TOKEN_TTL', 3600),
        'token_issuer' => env('APP_URL', 'default'),
        'secret'       => env('CENTRIFUGE_SECRET', null),
        'api_key'      => env('CENTRIFUGE_API_KEY', null),
        'ssl_key'      => env('CENTRIFUGE_SSL_KEY', null),
        'verify'       => env('CENTRIFUGE_VERIFY', false),
    ],
    // ...
],

您还可以在 .env 文件中添加配置

CENTRIFUGE_API_KEY=very-long-secret-api-key
CENTRIFUGE_SECRET=very-long-secret-key
CENTRIFUGE_URL=https://:8000
CENTRIFUGE_SSL_KEY=/etc/ssl/some.pem
CENTRIFUGE_TOKEN_TTL=3600 # seconds
CENTRIFUGE_VERIFY=false

别忘了安装广播驱动程序

BROADCAST_DRIVER=centrifuge

基本用法

要配置 Centrifugo 服务器，请参阅 官方文档

有关广播事件，请参阅 Laravel 官方文档

客户端使用的一个简单示例

<?php

namespace App\Http\Controllers;

use LaraComponents\Centrifuge\Centrifuge;

class ExampleController extends Controller
{
    public function home(Centrifuge $centrifuge)
    {
        // Send message into channel
        $centrifuge->publish('channel-name', [
            'key' => 'value'
        ]);

        // Generate api sign
        $apiSign = $centrifuge->generateApiSign('data');

        // ...
    }
}

可用方法

许可证

MIT 许可证（MIT）。有关更多信息，请参阅 许可证文件。