Жизненный цикл Request в Laravel

Жизненный цикл Request в Laravel — это процедура преобразования HTTP-запроса в HTTP-ответ. Понимание этого цикла имеет ключевое значение для разработки любых приложений на Laravel.

В этой статье мы пошагово рассмотрим жизненный цикл запроса в Laravel (как показано на схеме ниже) и объясню, как каждый компонент участвует в этом процессе.

Жизненный цикл: разбор каждого шага

1. Front Controller

Все запросы пользователей обрабатываются сервером и ведут на public/index.php файл.
У такого подхода есть название — паттерн FrontController.

2. Загрузка Composer Dependencies

Далее в index.php мы загружаем vendor/autoload.php . Это Composer автолоад файл, в котором будут подгружаться зависимости в вашем приложении по мере необходимости.

3. Создаем приложение

Файл bootstrap/app.php — это один из самых важных файлов Laravel. Он создаёт и настраивает экземпляр приложения.

Отвечает за:

Создание экземпляра Laravel Application (IoC контейнера).
Регистрация основных ядровых компонентов (HTTP Kernel, Console Kernel, Exception Handler).
Подготовку приложения к запуску (возвращает $app).

4. Service Providers

Service Providers — это фундамент Laravel. Без них фреймворк вообще не поднимется.

Они отвечают за

Регистрацию зависимостей в контейнере (IoC).
Инициализацию и настройку функционала.
В методе boot() выполняются действия, которые должны произойти после того, как все провайдеры зарегистрированы.
Здесь удобно добавлять Blade-директивы, кастомные валидаторы, слушатели событий, глобальные настройки.
Модульность и расширяемость.
Laravel и сторонние пакеты построены на провайдерах. Подключая или отключая их в config/app.php, можно гибко управлять функционалом.
Это делает приложение «собираемым» из модулей: авторизация, очередь, рассылки, платежи и т.д.

Где Service Providers регистрируются и запускаются

Все провайдеры регистрируются в массиве providers внутри config/app.php

Провайдеры регистрируются непосредственно на этапе bootstrap непосредственно перед отправкой запроса в middleware pipeline (конвеер выполнения middleware).

Жизненный цикл Request в Laravel - Service Providers

Пройдемся по стеку до инициализации всех ServiceProviders

// 1. See Handle method
//public/index.php:51
$response = $kernel->handle(
    $request = Request::capture()
)->send();

//2. See $this->sendRequestThroughRouter($request);
//vendor/laravel/framework/src/Illuminate/Foundation/Http/Kernel.php:144
    public function handle($request)
    {
        $this->requestStartedAt = Carbon::now();

        try {
            $request->enableHttpMethodParameterOverride();

            $response = $this->sendRequestThroughRouter($request);
        } catch (Throwable $e) {
            $this->reportException($e);

            $response = $this->renderException($request, $e);
        }

        $this->app['events']->dispatch(
            new RequestHandled($request, $response)
        );

        return $response;
    }

// 3. See $this->bootstrap();
//vendor/laravel/framework/src/Illuminate/Foundation/Http/Kernel.php:170
protected function sendRequestThroughRouter($request)
{
    $this->app->instance('request', $request);

    Facade::clearResolvedInstance('request');

    $this->bootstrap();

    return (new Pipeline($this->app))
                ->send($request)
                ->through($this->app->shouldSkipMiddleware() ? [] : $this->middleware)
                ->then($this->dispatchToRouter());
}

// 4. See $this->bootstrappers()
//vendor/laravel/framework/src/Illuminate/Foundation/Http/Kernel.php:186
 public function bootstrap()
 {
     if (! $this->app->hasBeenBootstrapped()) {
         $this->app->bootstrapWith($this->bootstrappers());
     }
}

// 5. See $this->bootstrappers
//vendor/laravel/framework/src/Illuminate/Foundation/Http/Kernel.php:486
protected function bootstrappers()
{
    return $this->bootstrappers;
}

// 6. See BootProviders class
//vendor/laravel/framework/src/Illuminate/Foundation/Http/Kernel.php:48
protected $bootstrappers = [
    ...
    \Illuminate\Foundation\Bootstrap\BootProviders::class,
];

//7. Inside $app->boot() method providers are loading
vendor/laravel/framework/src/Illuminate/Foundation/Bootstrap/BootProviders.php:17
public function bootstrap(Application $app)
{
    $app->boot();
}

А внутри $app->boot(); и происходит запуск ServiceProviders.

6. Routing

Routing — это механизм, который определяет, какой код (Контроллер) должен выполниться при обращении к конкретному URL.

Route::get('/users', [UserController::class, 'index']);

В Laravel маршруты определяются в файлах:

routes/web.php — для веб-страниц (Blade, сессии, cookies).
routes/api.php — для API (stateless, JSON).
routes/console.php — для Artisan-команд. Не используются при HTTP запросах.
routes/channels.php — для Broadcasting-каналов (WebSocket). Используется при работе с real-time приложениями.

5. Middleware

В Laravel middleware — это классы или методы, которые обрабатывают HTTP-запрос перед/после выполнением контроллера.

Как работает middleware

Клиент (браузер/мобильное приложение) отправляет запрос.
Перед тем как запрос попадёт в контроллер, Laravel прогоняет его через цепочку middleware.
Каждый middleware может:
- проверить запрос (например, авторизован ли пользователь),
- изменить запрос (например, добавить данные),
- остановить обработку (например, вернуть 403 или редирект).
После обработки контроллер возвращает ответ, и middleware может также обработать ответ перед отправкой клиенту.

Здесь запускается цепочка middleware vendor/laravel/framework/src/Illuminate/Foundation/Http/Kernel.php:175

7. Controller & View

После того как был определен route, и выполнены middleware, Laravel приложение выполняет Controller. В нем находится бизнес логика, обработка request, отправка данных во View.

8. Returning the Response

Когда контроллер отработал, он возвращает response. Этот response может быть разным:

HTML (HTML Page)
JSON (API — Response)
Redirect
Файл
Кастомный Resonse

После того как контроллер вернул ответ, он снова проходит через цепочку middleware которые должны выполниться после Controller.

И ответ возвращается пользователю.

Заключение

Жизненный цикл запроса в Laravel — это целая цепочка шагов, в которой каждый компонент играет свою роль: от начальной точки входа в index.php и загрузки зависимостей до выполнения middleware, контроллеров и формирования итогового ответа.

Понимание этого процесса помогает разработчику:

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

Laravel построен так, чтобы каждая часть системы была модульной, расширяемой и управляемой. Благодаря этому мы можем легко подключать пакеты, писать собственные middleware или провайдеры и при этом полностью контролировать поток обработки запроса.

Именно поэтому жизненный цикл Request —> Response — это не просто техническая схема, а основа архитектуры Laravel, знание которой делает разработчика увереннее и продуктивнее.