Начало проекта

Подготовка

composer create-project vesp/vesp ExampleBot

cd ExampleBot
valet link example-bot

mv .env .env.local

APP_NAME="Example Bot"

SITE_URL=http://example-bot.test/
API_URL=http://example-bot.test/api/

CORS=1 # Разрешаем кросс-доменные запросы к API

DB_DRIVER=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_PREFIX=app_
DB_DATABASE=ExampleBot
DB_USERNAME=root
DB_PASSWORD=root
DB_CHARSET=utf8mb4
DB_COLLATION=utf8mb4_general_ci
DB_FOREIGN_KEYS=1

JWT_SECRET=secret
JWT_EXPIRE=2592000
JWT_MAX=3

UPLOAD_DIR=/Users/developer/Projects/ExampleBot/upload/
CACHE_DIR=/Users/developer/Projects/ExampleBot/tmp/

composer node:generate

Создаём бота

BOT_USERNAME=ВашеИмяБота
BOT_API_KEY=ВашСекретныйТокен

Логика работы API Vesp

• Все запросы прилетают в www/api.php
• Там Slim инициализируется через PHP-DI, что сразу даёт нам поддержку контейнера зависимостей в контроллерах
• Затем добавлятся маршруты с контроллерами из core/routes.php
• Slim сверяет запрос с указанными маршрутами и передаёт его подходящему контроллеру
• Контроллер обрабатывает запрос и возвращает ответ через $this->success() или $this->failure() в формате JSON.

public function get(): Psr\Http\Message\ResponseInterface
{
    return $this->success('Hello World!');
}

public function post(): Psr\Http\Message\ResponseInterface
{
    // ...
}
public function patch(): Psr\Http\Message\ResponseInterface
{
    // ...
}

1. Создать контроллер в core/src/Controllers, который будет расширять Vesp\Controllers\Controller или его наследника.
2. Прописать в нём нужные публичные методы.
3. Указать этот контроллер для маршрута в core/routes.php
4. Ну и присылать запросы на этот адрес.

Проверяем связь с ботом

composer require longman/telegram-bot

<?php

namespace App\Services;

class Telegram extends \Longman\TelegramBot\Telegram
{
    public function __construct()
    {
        parent::__construct(getenv('BOT_API_KEY'), getenv('BOT_USERNAME'));
    }
}

<?php

namespace App\Controllers\Web;

use App\Services\Telegram;
use Longman\TelegramBot\Request;
use Psr\Http\Message\ResponseInterface;
use Vesp\Controllers\Controller;
use Vesp\Services\Eloquent;

class Test extends Controller
{
    protected Telegram $telegram;

    public function __construct(Eloquent $eloquent, Telegram $telegram)
    {
        parent::__construct($eloquent);
        $this->telegram = $telegram;
    }

    public function get(): ResponseInterface
    {
        $response = Request::getMe();
        if ($response->isOk()) {
            return $this->success($response->getResult());
        }

        return $this->failure($response->getDescription(), $response->getErrorCode());
    }
}

        $group->group(
            '/web',
            static function (RouteCollectorProxy $group) {
                $group->get('/test', App\Controllers\Web\Test::class);
            }
        );