Code Patterns

Переиспользуемые паттерны кодовой базы. Используй существующие — не изобретай новые без необходимости.

1. Kernel — статический контейнер

// Инициализация (один раз при старте воркера)
Kernel::init($container);

// Получение сервиса
$service = Kernel::getContainer()->get(MyService::class);

Kernel хранит единственный инстанс контейнера на весь процесс воркера.

2. ContainerFactory — сборка контейнера

$factory = new ContainerFactory($config, $environment);
$container = $factory->build();

Autoload: все файлы из routes/ и services/ подхватываются автоматически. Не регистрируй маршруты и сервисы вручную в index.php — кладёт файлы в соответствующие директории.

3. Router и RouteDefinition

// routes/api.php
return [
    new RouteDefinition('GET', '/users/{id}', UserController::class, 'show'),
];

Router находит нужный маршрут по методу и пути, извлекает параметры и вызывает контроллер.

4. Middleware — цепочка обработки запроса

class MyMiddleware implements MiddlewareInterface {
    public function handle(Request $request, callable $next): Response {
        // до
        $response = $next($request);
        // после
        return $response;
    }
}

Middleware регистрируются в контейнере и применяются ко всем запросам в воркере.

5. ORM — атрибуты сущностей

#[Collection('users')]
class UserEntity {
    #[Field('_id')]
    public string $id;

    #[Field('name')]
    public string $name;
}

Repository наследует базовый класс и получает методы find, findOne, save, delete из коробки.

6. JWT Auth

// AuthMiddleware автоматически валидирует Bearer-токен
// В контроллере — получить текущего пользователя из request
$user = $request->getAttribute('user');

JwtService отвечает за выпуск и верификацию токенов. Конфиг: секрет и TTL через Config.

7. Config — конфигурация

$value = Config::get('key');
$value = Config::get('section.key', $default);

Конфиг загружается из environment.php (или .env). Доступен глобально через статический метод.

8. WorkerRunner — цикл обработки запросов

// Внутри worker.php
$runner = new WorkerRunner($kernel);
$runner->run(); // FrankenPHP loop: запрос → роутинг → middleware → контроллер → ответ

WorkerRunner перехватывает исключения и возвращает корректный HTTP-ответ даже при ошибке.

3.3 KiB Raw Permalink Blame History Unescape Escape