jonston/laravel-chat

Laravel Chat Package

dev-master 2026-01-21 17:34 UTC

Requires

• php: ^8.1
• illuminate/support: ^9.0|^10.0|^11.0|^12.0

Requires (Dev)

• orchestra/testbench: ^8.0|^9.0|^10.0|^11.0|^12.0
• phpunit/phpunit: ^10.0

MIT

• Jonston

README

Пакет для реализации чата в Laravel приложениях.

Установка

Установите пакет через Composer:

composer require jonston/laravel-chat

Публикация ресурсов

Публикация конфигурации

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

Публикация миграций

php artisan vendor:publish --tag=chat-migrations

После публикации миграций, выполните:

# Laravel Chat

Лёгкий пакет для добавления базовой функциональности чата в Laravel-проекты.

Ключевые возможности:
- Публикуемые конфигурация и миграции
- Модели для комнат, сообщений и «обёртки» участников
- Сервис `ChatService` для создания комнат, сообщений и управления участниками

## Установка

Установите пакет через Composer (пример):

```bash
composer require jonston/laravel-chat

Публикация ресурсов

Публикация конфигурации:

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

Публикация миграций:

php artisan vendor:publish --tag=chat-migrations

Для удобства есть групповой тег chat, который публикует и конфиг, и миграции:

php artisan vendor:publish --tag=chat

После публикации миграций выполните:

php artisan migrate

Конфигурация

Файл config/chat.php позволяет настроить:

• Имена таблиц
• Используемые модели (комнат, сообщений, участников, гостей, ботов)
• Параметры пагинации и пр.

По умолчанию модели пакета находятся в Jonston\LaravelChat\Models и имена таблиц — в config/chat.php.

Использование

Пример быстрого использования ChatService в приложении:

$service = new \Jonston\LaravelChat\Services\ChatService();
$room = $service->createRoom('Support');
$guestClass = config('chat.models.guest');
$guest = ($guestClass)::create(['name' => 'Visitor']);
$member = $service->addMember($guest);
$message = $service->createMessage($member, $room, 'Hello!');

Тесты

Пакет содержит набор unit/feature тестов, которые запускаются через PHPUnit / Orchestra Testbench.

Контрибьютинг

PR и issues приветствуются.

Лицензия

MIT