🔍 Laravel Request Lifecycle: что происходит до того, как сработает твой контроллер

Контроллер — это не начало запроса, а середина. К моменту, когда выполняется его тело, фреймворк уже прошёл половину пути. Этот путь объясняет, почему register() ≠ boot(), почему route binding — не магия контроллера, и почему синглтоны убивают вас в Octane.

1️⃣ Точка входа

Веб-сервер ничего не знает про роуты и Eloquent. Его задача — отдать запрос в public/index.php. Дальше:
— грузится автолоадер Composer;
— из bootstrap/app.php достаётся инстанс приложения (он же — service container);
— Request::capture() оборачивает $_GET/$_POST/$_SERVER в Illuminate\Http\Request (наследник Symfony Request);
— $app->handleRequest(...) резолвит HTTP Kernel, гоняет запрос, шлёт ответ и терминирует.

2️⃣ HTTP Kernel — координатор, а не бизнес-логика

Включает method override (_method для PUT/PATCH/DELETE), отправляет запрос в роутер, ловит исключения и превращает их в HTTP-ответ через хендлер, диспатчит RequestHandled.

3️⃣ Бутстрап (по порядку)

env → config → exceptions → facades → register providers → boot providers.

Порядок критичен:
→ register() — только биндинги в контейнер, ничего не резолвить
→ boot() — настройка уже зарегистрированных сервисов (гейты, события, view composers)

Правило: биндишь в register, настраиваешь в boot. Иначе словишь зависимость от ещё не зарегистрированного сервиса.

4️⃣ Middleware

Запрос идёт внутрь, ответ — наружу через тот же стек.
— код до $next($request) → на входе
— код после → на выходе (можно менять готовый ответ)

Сначала глобальный стек (CORS, TrustProxies, trim, maintenance), потом роутер. Кто первым увидел запрос, последним увидит ответ.

5️⃣ Роутинг

Роутер матчит route (метод, домен, URI, констрейнты), привязывает route resolver к запросу (поэтому потом работает $request->route()), диспатчит Routing и RouteMatched.

6️⃣ Route middleware + биндинг

Отдельный pipeline под middleware роута (web, api, auth...). Здесь же SubstituteBindings подменяет {post:slug} на модель Post до вызова контроллера. Route model binding живёт в pipeline, а не внутри экшена.

7️⃣ Экшен

Контроллер резолвится из контейнера через make(), а не new — отсюда DI в конструкторе. FormRequest резолвится, авторизуется и валидируется до входа в метод. К началу тела экшена за тебя уже сделана куча работы.

8️⃣ Ответ

Что бы ты ни вернул — строку, массив, модель, Responsable, view — Laravel нормализует в Symfony Response (массив → JSON и т.д.). Дальше ответ идёт назад: route → global middleware. Контроллер вернул одно, а браузер получил другое? Смотри middleware после $next.

9️⃣ send() и terminate()

$response->send() и клиент получил ответ. Но lifecycle не закончен: terminate() запускает terminable middleware и termination callbacks *после* отправки. Удобно для метрик и лёгкого клинапа.

Нюанс: на terminate() middleware резолвится из контейнера заново. Нужен тот же инстанс, что в handle(), так что регай синглтоном. А тяжёлую работу в очередь, не в post-response.

🔟 Octane / queue workers

Классический PHP — свежий процесс на каждый запрос. Длинноживущие воркеры держат приложение в памяти между запросами. Синглтон с request-данными → утечка состояния в соседний запрос. Для request/job-scoped сервисов — scoped(): резолвится раз за lifecycle и сбрасывается на новом.

Библиотека пхпшника

😎 Знакомьтесь с экспертом Proglib.academy: Senior Software Engineer и Team Lead в Yandex Cloud Роман Барлос

Роман — консультант нашего курса «Разработка ИИ-агентов». Он работает на стыке cloud-native архитектуры и AI, активно внедряя современные ИИ-подходы в реальные процессы разработки.

За что его ценит IT-комьюнити?

🟣 Team Lead и AI-евангелист в команде UX Yandex Cloud

14-лет в разработке. Занимается AI-адопшеном в команде Yandex Cloud, проводит мастер-классы и продвигает лучшие практики для повышения эффективности разработчиков.

🟣 Техлид Sourcecraft Code Assistant

С сильным практическим бэкграундом принимал участие как технический лид в создании мощного AI-расширения для VS Code.

🟣 Создатель полезного Open Source

Разрабатывает утилиты, которые позволяют быстро начать эксперименты с инференсом и агентами в локальном окружении: например, набор скриптов vllm-setup для быстрого запуска окружения и mini-proxy — минималистичный прокси для OpenAI API провайдеров.

🟣 Автор интерактивных ML-визуализаций

Объясняет сложные концепции наглядно. Создал серию залипательных обучающих материалов, где можно вживую пощупать работу сетей Хопфилда, машин Больцмана и VC-размерности.

Роман регулярно делится инженерными наработками, инсайтами и экспертизой в своем авторском Telegram-канале

На курсе Роман выступает консультантом программы: он помогает формировать содержание уроков с опорой на актуальные инженерные практики и жесткие требования индустрии.

Узнать больше о программе и разработке автономных систем:
👉 Курс «Разработка ИИ-агентов»

Так, продолжаем знакомить вас с командой?
👍 — Да, ждем новых лиц
🔥 — Жду полезные материалы от Романа

✔️ PHP-тест: список, который иногда становится объектом

Мобилка падает на парсинге ответа. Только у части пользователей. У остальных — всё ок.

📦 Задание

Эндпоинт /api/products/available отдаёт товары в наличии. Бэкенд не трогали месяц. Внезапно прилетает баг от мобильной команды: «приложение крашится при разборе items, иногда это массив, иногда какой-то объект с числовыми ключами». На стейджинге не воспроизводится — там тестовые данные, все товары в наличии.

// src/Api/ProductController.php
class ProductController
{
    public function __construct(
        private readonly ProductRepository $repository,
    ) {}

    public function available(): JsonResponse
    {
        $products = $this->repository->findAll();

        $available = array_filter(
            $products,
            fn (Product $p): bool => $p->getStock() > 0,
        );

        return new JsonResponse([
            'items' => $available,
            'count' => count($available),
        ]);
    }
}

🔹 Задачи

— Объяснить, почему форма ответа items зависит от данных: то массив, то объект
— Объяснить, при каком наборе товаров json_encode отдаёт {"0":…, "2":…} вместо […]
— Исправить так, чтобы items гарантированно сериализовался как JSON-массив

Ставьте → 🔥 если нравится формат. Если нет → 🌚

💬 Решения пишите в комменты под спойлер — сравним подходы.

🧩 Один разработчик, 10 лет, ввой PHP-фреймворк

На Хабре вышла статья про LOTIS (Low Time Script) — фреймворк, который автор в одиночку допиливал десять лет под бизнес-приложения (учёт товаров, документы, расчёт зарплат, прибыли).

Идея у него радикальная: никаких шаблонов и разметки. Всё веб-приложение собирается из PHP-объектов, а клиентский и серверный код живут рядом, как в десктопе.

В основе принцип, который автор назвал CMA: Construct → Metadata → Assembly:
→ объекты реализуют общий интерфейс Construct;
→ они генерируют метаданные;
→ а класс Space уже собирает из них DOM, реактивность или API.

То есть ты описываешь не <div>, а объект предметной области. И пока не отдашь его «во вселенную» (LTS::Space()->build(...)) — это просто объект, которому можно менять вложенность простым перераспределением наследования.

Не инструмент «нести в прод завтра», но честная, выстраданная попытка переосмыслить разработку веб-приложений на PHP. Как минимум — хороший повод подумать о метаданных и декларативном UI. Сейчас автор портирует архитектуру на Node.js (PWA, локальные БД, оффлайн).

Любопытно, спорно, авторски. Разбор и куски боевого кода в оригинале

💬 Что думаете?

Библиотека пхпшника

⚡️ Работаем с curl

Нужно скачать файл и продолжить загрузку после обрыва? curl -C - автоматически продолжит с того места, где остановился — не нужно качать заново.

🔹 Зачем это нужно

— Загрузка больших файлов через нестабильное соединение.
— Автоматически определяет размер уже скачанной части и продолжает.
— Работает с HTTP, FTP и даже SFTP.

🔹 Как использовать

— Скачать с возможностью продолжения: curl -C - -O https://example.com/dump.sql.gz
— С прогресс-баром: curl -C - -# -O https://example.com/large-file.tar.gz
— Ограничить скорость: curl --limit-rate 10M -O https://example.com/file.iso
— В конкретный файл: curl -C - -o backup.tar.gz https://example.com/backup
— С авторизацией: curl -C - -u user:pass -O https://repo.example.com/artifact.jar

💡 Заверни в цикл для автоматического ретрая: while ! curl -C - -O https://example.com/dump.sql.gz; do sleep 5; done — скрипт будет пытаться докачать, пока не получится.

⌨️ Топ-вакансий по PHP за неделю

PHP-разработчик — до 200 000 ₽ — удалёнка

PHP-разработчик — от 200 000 ₽ — гибрид (Москва)

Fullstack разработчик (Laravel + Vue.js/React.js) — от 1600 до 2240 $ — удалёнка

➡️ Еще больше топовых вакансий — в нашем канале PHP Jobs

🛒 Ecommerce-фреймворк, где ядро можно переопределять, не форкая

Bagisto — open-source ecommerce на Laravel 12 (PHP 8.3+), 27k звёзд.

Но интересен он не «магазином из коробки», а тем, как устроена кодовая база: это не монолит, а 30+ самостоятельных пакетов под Webkul\*, каждый со своими роутами, миграциями, моделями и тестами. Подключаются через Composer path-repositories и обычные сервис-провайдеры.

Каждая модель реализует контракт (интерфейс), а резолвится в рантайме через прокси. На практике это значит, что свой пакет может подменить ядровую модель Product или Order без правки core-файлов и без форка:

// твой ServiceProvider
$this->app->concord->registerModel(
    \Webkul\Product\Contracts\Product::class,
    \App\Models\CustomProduct::class
);

Каталог построен на EAV — гибкая схема атрибутов вместо раздувания таблицы товаров. Атрибуты раскладываются по families/groups, а значения пишутся в product_attribute_values, причём тип атрибута маппится на конкретную колонку через $attributeTypeFields (text / boolean / integer / datetime), а не сваливается в один value.

Доступ к данным — через repository pattern на prettus/l5-repository. Базовый Webkul\Core\Eloquent\Repository даёт критерии-фильтры, кэширование и оптимизацию запросов поверх Eloquent:

class ReturnRequestRepository extends Repository
{
    public function model(): string
    {
        return 'Webkul\RMA\Contracts\ReturnRequest';
    }
}

Из коробки также мультиканальность/мультитенант, POS, headless через Next.js и Flutter-приложение в отдельных репо. Админка на Vue 3.

Хороший кейс, если хочется посмотреть, как держать большой Laravel-проект модульным и расширяемым без боли при апгрейдах.

🔗 Репозиторий на GitHub

🐸 Библиотека пхпшника