mevadakalpesh/chatapp

该包的最新版本(dev-main)没有提供许可证信息。

使用 mevadakalpesh/chatapp 为您的 Laravel 应用程序提供实时聊天功能。一个无缝且可定制的解决方案,可增强用户沟通。

dev-main 2024-06-10 10:28 UTC

This package is auto-updated.

Last update: 2024-09-10 10:57:36 UTC


README

ChatApp 是一个使用 LiveWire 和 Beyond WebSocket 构建的简单且灵活的聊天应用程序包。它为网络应用程序提供实时聊天功能,便于集成并根据项目需求进行定制。

特性

  • 实时聊天功能。
  • 使用 LiveWire 进行无缝服务器端渲染。
  • 使用 Beyond WebSocket 进行高效的 WebSocket 通信。
  • 易于集成和定制。

安装

您可以通过 composer 安装此包,如果命令出错,请将 :dev-main 添加到最后作为版本号

composer require mevadakalpesh/chatapp

在安装包后,在 config/app.phpProviders 中添加此提供程序

Mevadakalpesh\ChatApp\ChatAppServiceProviders

您可以使用以下命令发布配置文件

php artisan vendor:publish --provider="Mevadakalpesh\ChatApp\ChatAppServiceProvider" --tag=chatapp

在您的 package.json 中添加此代码

"dependencies": {
		.......

        "emojionearea": "^3.4.2",
        "laravel-echo": "^1.15.3",
        "pusher-js": "^8.4.0-rc2"

        .......
}

添加此代码后,运行此命令

npm install

之后,通过运行此命令创建模型

php artisan make:model Message

并在 Message 模型中替换此代码

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;

class Message extends Model
{
    use HasFactory;
    protected $guarded = [];
}

resources/js/bootstrap.js 中添加或替换此代码

import Echo from 'laravel-echo';

import Pusher from 'pusher-js';
window.Pusher = Pusher;

window.Echo = new Echo({
    broadcaster: 'pusher',
    key: import.meta.env.VITE_PUSHER_APP_KEY,
    cluster: import.meta.env.VITE_PUSHER_APP_CLUSTER ?? 'mt1',
    wsHost: import.meta.env.VITE_PUSHER_HOST ? import.meta.env.VITE_PUSHER_HOST : `ws-${import.meta.env.VITE_PUSHER_APP_CLUSTER}.pusher.com`,
    wsPort: import.meta.env.VITE_PUSHER_PORT ?? 80,
    wssPort: import.meta.env.VITE_PUSHER_PORT ?? 443,
    forceTLS: (import.meta.env.VITE_PUSHER_SCHEME ?? 'https') === 'https',
    enabledTransports: ['ws', 'wss'],
});

更改或添加一些 ENV 变量

BROADCAST_DRIVER=pusher


PUSHER_APP_ID=LOGICID
PUSHER_APP_KEY=LOGICWI828
PUSHER_APP_SECRET=KSK8372U
PUSHER_HOST=127.0.0.1
PUSHER_PORT=6001
PUSHER_SCHEME=http
PUSHER_APP_CLUSTER=mt1

运行此命令以启动 WebSocket

php artian route:clear
php artisan route:clear
php artisan websockets:ser

现在,通过输入此 URL http://127.0.0.1:8001/chat-app/ 测试聊天应用程序

测试

composer test

更新日志

请参阅 CHANGELOG 了解最近更改的更多信息。

贡献

请参阅 CONTRIBUTING 了解详细信息。

许可证

MIT 许可证 (MIT)。请参阅 许可证文件 了解更多信息。