Как встроить систему приглашений в свое приложение с помощью Laravel и GraphQL
Привет, Хабр! Меня зовут Екатерина Саяпина, я Product Owner личного кабинета платформы МТС Exolve. В этом посте расскажу, как встроить систему приглашений в приложение с помощью Laravel и GraphQL. Эту задачу можно выполнить не только по привычным каналам вроде email, но и через SMS API. Мы разберем процесс интеграции от создания модели на Laravel и работы с GraphQL до отправки сообщений через API Exolve.
Система приглашений — это еще один вариант взаимодействия, когда пользователи могут отправить кому-нибудь из вашего приложения уникальный код или ссылку. Например, вы разрабатываете социальную платформу или продукт и хотите, чтобы люди делились ключами для него. Такая система улучшает пользовательский опыт и может повысить качество ваших сервисов.
Laravel — мощный инструмент для создания бекенда
Laravel давно зарекомендовал себя как отличный фреймворк для PHP-разработчиков. У него удобный синтаксис, четкая структура кода и огромное количество встроенных возможностей — все это делает его идеальным выбором для создания API у приложений. В нашем кейсе задействуем маршруты, контроллеры, модели и интеграцию с GraphQL.
Также в проекте мы будем использовать GraphQL: в отличие от традиционного REST API, он позволяет получить ровно те данные, которые нам нужны, без избыточных данных. Мы применим GraphQL для взаимодействия между нашим клиентом и сервером, чтобы передавать информацию о приглашениях и пользователях. Запросы через GraphQL более гибкие и мощные, а их настройка под Laravel проста и логична.
Шаг 1: Настраиваем Laravel
Предположим, что вы уже знакомы с основами установки Laravel и работой с миграциями и моделями. Мы пропустим базовые шаги и сразу перейдем к созданию модели для приглашений. Для тех, у кого не было опыта работы с Laravel, у проекта есть гайд для быстрого старта в официальной документации.
Модель Invite будет содержать поля для хранения информации об отправителе, о получателе, а также о статусе приглашения. Для начала создадим миграцию:
php artisan make:model Invite -mДобавляем в нее поля:
Schema::create('invites', function (Blueprint $table) {
$table->id();
$table->foreignId('sender_id')->constrained('users')->onDelete('cascade');
$table->string('invitee_phone');
$table->string('invite_code')->unique();
$table->enum('status', ['pending', 'accepted', 'declined'])->default('pending');
$table->timestamps();
});Теперь у нас есть основа, которая позволит хранить информацию о приглашениях. Это важно, потому что далее мы будем работать с этой моделью, чтобы создавать и отправлять сообщения.
Шаг 2: GraphQL-запросы для приглашений
Теперь, когда у нас есть модель, необходимо интегрировать ее с GraphQL. Если вы еще не подключили GraphQL к Laravel, рекомендую использовать библиотеку laravel-graphq — она значительно упростит жизнь.
Сначала создадим несколько мутаций, через которые будем создавать новые приглашения:
use GraphQL\Type\Definition\Type;
use Rebing\GraphQL\Support\Mutation;
use App\Models\Invite;
class CreateInviteMutation extends Mutation
{
protected $attributes = [
'name' => 'createInvite'
];
public function type(): Type
{
return Type::boolean();
}
public function args(): array
{
return [
'invitee_phone' => ['name' => 'invitee_phone', 'type' => Type::string()],
];
}
public function resolve($root, $args)
{
$invite = Invite::create([
'sender_id' => auth()->id(),
'invitee_phone' => $args['invitee_phone'],
'invite_code' => Str::random(10),
]);
return $invite ? true : false;
}
}Эта мутация добавит новую запись в таблицу приглашений и сгенерирует уникальный код, который в дальнейшем мы перешлем по SMS.
Шаг 3: Интеграция с API Exolve
Теперь самое интересное — отправка сообщений через SMS. Для этого мы будем использовать API Exolve. Если вы еще не знакомы с ним, то рекомендую обратиться к документации — там все достаточно просто и понятно.
В нашем случае нужно отправить POST-запрос с телефоном приглашенного и текстом сообщения. Чтобы это сделать, мы напишем службу, которая будет отвечать за интеграцию с Exolve API.
Создадим новый сервисный класс:
namespace App\Services;
use Illuminate\Support\Facades\Http;
class SmsService
{
protected $apiUrl = 'https://api.exolve.com/send';
public function sendInvite($phone, $message)
{
$response = Http::post($this->apiUrl, [
'phone' => $phone,
'message' => $message,
]);
return $response->successful();
}
}Теперь нам нужно вызывать этот сервис в момент создания приглашения, чтобы отправить его по SMS. Мы можем сделать это прямо в нашей мутации GraphQL:
use App\Services\SmsService;
class CreateInviteMutation extends Mutation
{
public function resolve($root, $args)
{
$invite = Invite::create([
'sender_id' => auth()->id(),
'invitee_phone' => $args['invitee_phone'],
'invite_code' => Str::random(10),
]);
$smsService = new SmsService();
$smsService->sendInvite($args['invitee_phone'], 'Ваш код приглашения: ' . $invite->invite_code);
return $invite ? true : false;
}
}Как видите, это простой и удобный способ интеграции с Exolve. В этом варианте мы передаем по SMS уникальный код, но можем взять вместо него, например, ссылки.
Заключение
Интеграция системы приглашений с использованием Laravel и GraphQL — это не только функционально, но и гибко. Можно добавлять новые виды сообщений, менять логику рассылки или интегрировать другие API. В этом примере мы использовали Exolve для отправки SMS, но в целом логика универсальна и для иных схожих по сути проектов.
Надеемся, этот пример поможет упростить процесс взаимодействия с пользователями. Если вам интересна эта тема, то оставляйте вопросы в комментариях, объясню подробнее.
