README

Laravel 消息传递器

此包允许您将完整用户消息系统添加到您的 Laravel 应用程序中。

留下一些反馈

您如何使用 laravel-messenger？

特性

• 每个用户可以有多个会话
• 可选地，每条新消息都可以循环引入更多用户
• 查看每个线程的最后一条消息
• 返回系统中的所有消息，与用户关联的所有消息，或与用户关联的新/未读消息
• 轻松返回用户未读消息数
• 非常灵活，您可以实现自己的访问控制

常见用途

• 公开线程（每个人都可以看到一切）
• 群组消息（只有参与者可以看到他们的线程）
• 一对一消息（私密或直接线程）

Laravel 版本

安装（Laravel 4.x - 已停止积极支持）

Laravel 4 的安装说明可以在这里找到。

安装（Laravel 5.x）

composer require cmgmyr/messenger

或在 composer.json 中手动添加

"require": {
    "cmgmyr/messenger": "~2.0"
}

运行

composer update

将服务提供者添加到 config/app.php 下的 providers

'providers' => [
    Cmgmyr\Messenger\MessengerServiceProvider::class,
],

注意：如果您使用的是 Laravel 5.5，此步骤是不必要的。Laravel Messenger 支持 包发现。

发布配置

php artisan vendor:publish --provider="Cmgmyr\Messenger\MessengerServiceProvider" --tag="config"

更新配置文件以引用您的用户模型

config/messenger.php

如果您还没有，请创建一个 users 表。如果您需要，默认的 Laravel 迁移就足够了。

（可选） 如果您不想使用默认的数据库表名，可以在包配置文件中定义数据库表名

'messages_table' => 'messenger_messages',
'participants_table' => 'messenger_participants',
'threads_table' => 'messenger_threads',

发布迁移

php artisan vendor:publish --provider="Cmgmyr\Messenger\MessengerServiceProvider" --tag="migrations"

迁移您的数据库

php artisan migrate

将特质添加到您的用户模型中

use Cmgmyr\Messenger\Traits\Messagable;

class User extends Authenticatable {
    use Messagable;
}

示例

• 控制器
• 路由
• 视图

示例项目

• [WIP] Pusher
• [WIP] Lumen API

贡献

请参阅 CONTRIBUTING 以获取详细信息。

安全漏洞

请查阅 我们的安全策略 了解如何报告安全漏洞。

致谢

• Chris Gmyr
• Anton Komarev
• 所有贡献者

特别感谢

此包以 AndreasHeiberg/laravel-messenger 为起点。