mercurius

Mercurius - Laravel 的 Messenger" style="max-width: 100%;">

目录

• 关于
• 预览
• 特征
• 截图
• 演示
• 安装
• 定制化
• 路线图
• 支持
• 贡献
• 变更日志
• 制作人员
• 版权与许可

关于

mercurius是一个使用 Laravel 和 Vue.js 的实时消息系统，具有完整的应用程序，您可以轻松地在任何 Laravel 项目中安装它。

预览

Mercurius 预览" data-animated-image="" style="max-width: 100%;">

特征

• 实时通讯工具
• 反应灵敏
• 多种语言
• 浏览器通知
• 独特的用户体验，深色主题
• 打字指示器
• 删除对话和消息
• 使用自动完成功能搜索收件人

截图

单击大拇指可放大图像

演示

您可以尝试mercurius的演示。使用以下任一凭据进行身份验证：

• [email protected]
• [email protected]
• [email protected]

密码： password

提示：打开2个不同的浏览器并使用不同的用户名登录，以便您可以测试发送/接收消息。

安装

在继续之前确保 Laravel 5.6 + 已安装。

1. 设置推送器

如果您没有帐户，请在 Pusher.com 网站上创建一个免费帐户。转到仪表板，创建一个新应用程序并记下 API 凭据。

现在，让我们将 API 密钥添加到.env文件中。另外，将BROADCAST_DRIVER更改为pusher （默认为log ）。

 . . .
BROADCAST_DRIVER =pusher
. . .
PUSHER_APP_ID ="xxxxxx"
PUSHER_APP_KEY ="xxxxxxxxxxxxxxxxxxxx"
PUSHER_APP_SECRET ="xxxxxxxxxxxxxxxxxxxx"
PUSHER_APP_CLUSTER ="xx"

2.注册BroadcastServiceProvider

打开config/app.php并取消注释行AppProvidersBroadcastServiceProvider::class, 。

3. Laravel 身份验证

如果身份验证已设置，请跳过此步骤，否则键入：

php artisan make:auth

4.安装mercurius

composer require launcher/ mercurius 

5. 配置（可选）

如果要更改默认配置，请通过键入以下命令来发布配置文件：

php artisan vendor:publish --tag= mercurius -config

要编辑配置，请打开/config/ mercurius .php并添加您自己的值。

mercurius Models |-------------------------------------------------------------------------- | | Defines the models used with mercurius , use it to extend mercurius and | create your own implementation. | */ 'models' => [ 'user' => AppUser::class, 'messages' => Launcher mercurius ModelsMessage::class, ], /* |-------------------------------------------------------------------------- | User Table Fields |-------------------------------------------------------------------------- | | You can specify the column names for the user table. The `name` accepts | an array of fields, for building custom names with multiple columns. | */ 'fields' => [ // 'name' => ['first_name', 'last_name'], 'name' => 'name', 'slug' => 'slug', 'avatar' => 'avatar', ], ];">

 return [

    /*
    |--------------------------------------------------------------------------
    | mercurius Models
    |--------------------------------------------------------------------------
    |
    | Defines the models used with mercurius , use it to extend mercurius and
    | create your own implementation.
    |
    */

    ' models ' => [
        ' user ' => App User::class,
        ' messages ' => Launcher  mercurius  Models Message::class,
    ],

    /*
    |--------------------------------------------------------------------------
    | User Table Fields
    |--------------------------------------------------------------------------
    |
    | You can specify the column names for the user table. The `name` accepts
    | an array of fields, for building custom names with multiple columns.
    |
    */

    ' fields ' => [
        // 'name'   => ['first_name', 'last_name'],
        ' name '   => ' name ' ,
        ' slug '   => ' slug ' ,
        ' avatar ' => ' avatar ' ,
    ],
];

6.安装mercurius

mercurius:install composer dump-autoload">

php artisan mercurius :install
composer dump-autoload

7. 用户特征

将Launcher mercurius mercurius User特征添加到您的User模型中：

mercurius User; class User extends Authenticatable { use mercurius User; // ... }">

 // ...
use Illuminate  Foundation  Auth  User as Authenticatable ;
use Launcher  mercurius  mercurius User ;

class User extends Authenticatable
{
    use mercurius User;
    // ...
}

8.安装虚拟数据（用于测试）

php artisan db:seed --class= mercurius DatabaseSeeder

将向系统添加消息和用户，如演示示例所示：

演示用户：

• 伊恩： [email protected]
• 诺亚： [email protected]
• 卢阿： [email protected]

密码： password

更新mercurius

每当您更新mercurius时，请确保发布资源以应用新版本的 CSS/JS。

php artisan vendor:publish --tag= mercurius -public --force

定制化

请参阅定制以获取更多信息。

路线图

查看路线图以获取更多信息。

• 单元测试
• 与多个用户对话 #13
• 网络钩子#16
• 上传照片和文件 #14
• 预览图像和视频 #15
• 表情符号支持 #18
• 视频聊天 #19
• 支持socket.io #20
• 搜索消息 #17

支持

• 创建一个新问题
• 加入我们的 Slack 频道

贡献

请参阅贡献以获取更多信息。

变更日志

我们保留变更日志，其中包含已更改的信息。

制作人员

• 布鲁诺·托林哈
• 所有贡献者

版权和许可

版权所有 2018 布鲁诺·托林哈。 mercurius是根据 MIT 许可证发布的。