К содержимому
Войти

PHP Road Map

🔄 Жизненный цикл запроса в Laravel

Каждый HTTP-запрос в Laravel проходит один и тот же путь: public/index.php, создание приложения, HTTP-ядро, сервис-провайдеры, глобальные middleware, роутер, middleware маршрута, контроллер и обратно. Зная этот путь, понимаешь, куда положить проверку токена, почему биндинг из register не находит зависимость и почему после config:cache функция env() возвращает null. На собеседовании это один из первых вопросов по Laravel

Как запрос доходит от nginx до public/index.php, разобрано на странице «Путь запроса и PHP-FPM». Здесь начинаем с момента, когда воркер FPM открыл index.php

🧠 Как это устроено

Путь по шагам

  1. public/index.php засекает LARAVEL_START, проверяет файл storage/framework/maintenance.php (если приложение в режиме обслуживания, ответ отдаётся ещё до загрузки фреймворка), подключает автозагрузчик Composer
  2. bootstrap/app.php создаёт экземпляр Illuminate\Foundation\Application. Это и есть сервис-контейнер. Сюда же через Application::configure() передаются маршруты, middleware и обработка исключений
  3. index.php вызывает $app->handleRequest(Request::capture()). Приложение достаёт из контейнера HTTP-ядро Illuminate\Foundation\Http\Kernel и отдаёт ему запрос
  4. Ядро запускает бутстрапперы по порядку: LoadEnvironmentVariables (читает .env), LoadConfiguration (загружает config/*.php), HandleExceptions, RegisterFacades, RegisterProviders, BootProviders. На двух последних шагах вызываются register и boot у всех провайдеров
  5. Запрос проходит через глобальные middleware ядра: TrustProxies, HandleCors, PreventRequestsDuringMaintenance, ValidatePostSize, TrimStrings, ConvertEmptyStringsToNull и другие
  6. Роутер ищет маршрут. Нет совпадения — 404. Нашёл — собирает middleware маршрута: группу (web или api), middleware самого маршрута и контроллера, сортирует их по списку приоритетов
  7. Внутри группы SubstituteBindings превращает {order} из URI в модель Order (это и есть route model binding). Модели нет в базе — 404
  8. Контейнер создаёт контроллер, внедряет зависимости в конструктор и метод, вызывает действие
  9. Всё, что вернул контроллер (модель, массив, строку, view), роутер превращает в объект Response, и тот идёт обратно через те же middleware в обратном порядке
  10. handleRequest вызывает $response->send(), затем $kernel->terminate(): события Terminating, методы terminate() у middleware, колбэки app()->terminating()

Всё, что между Request и Response, настраивается в трёх местах: bootstrap/app.php, bootstrap/providers.php и файлы в routes/

Сервис-провайдеры: register против boot

Провайдер подключает к приложению кусок функциональности: биндинги, слушатели событий, маршруты, макросы. Свои провайдеры перечислены в bootstrap/providers.php, make:provider дописывает туда новый класс сам. Фреймворк и пакеты добавляют ещё десятки своих

Laravel проходит по провайдерам в два прохода. Сначала у всех вызывается register, и только потом у всех вызывается boot. Отсюда правило:

  • в register только кладёшь в контейнер: bind, singleton, scoped. Ничего не достаёшь и не вызываешь
  • в boot можно пользоваться чем угодно: к этому моменту зарегистрировано всё. Здесь вешают слушатели, Route::bind, view composer, Model::preventLazyLoading(), Gate::define. Зависимости можно объявить параметрами boot, контейнер их внедрит

Почему в register нельзя трогать другие сервисы. Порядок провайдеров не гарантирует, что нужный сервис уже зарегистрирован: твой провайдер может стоять раньше провайдера пакета. Тогда app(Cache::class) в register упадёт с ошибкой или, хуже, контейнер соберёт объект с настройками по умолчанию, а провайдер пакета потом перебьёт биндинг. В замыкании singleton(fn ($app) => ...) обращаться к другим сервисам можно: оно выполнится позже, при первом make. Конфигурация уже доступна в register, её загружает бутстраппер до провайдеров

Отложенный провайдер реализует Illuminate\Contracts\Support\DeferrableProvider и метод provides() со списком сервисов. Laravel запоминает этот список в bootstrap/cache/services.php и не загружает провайдер, пока кто-то не попросит один из этих сервисов из контейнера. Отложить можно только провайдер, который ничего не делает, кроме биндингов: слушатель события или маршрут из отложенного провайдера не зарегистрируется, пока его сервис никто не запросил

Middleware: где они стоят и в каком порядке

Middleware — класс с методом handle(Request $request, Closure $next). Всё, что написано до $next($request), выполняется на пути внутрь, всё после — на пути с ответом наружу. Как это устроено как паттерн (цепочка обязанностей через Illuminate\Pipeline\Pipeline), разобрано на странице «Паттерны проектирования в PHP». Здесь важны уровни:

УровеньГде настраиваетсяКогда выполняется
глобальныеwithMiddleware: append, prepend, insertBefore, useна каждый запрос, до поиска маршрута
группы web и api$middleware->web(append: [...]), api(...), appendToGroupпосле того как роутер нашёл маршрут из routes/web.php или routes/api.php
маршрута->middleware('auth') в routes/вместе с группой, после поиска маршрута
контроллераинтерфейс HasMiddleware или атрибут #[Middleware]там же, сливаются с middleware маршрута

Группа web по умолчанию: шифрование кук, сессия, ошибки валидации из сессии, PreventRequestForgery (CSRF с проверкой origin в Laravel 13) и SubstituteBindings. В api из коробки только SubstituteBindings: ни сессии, ни CSRF. Файла routes/api.php в новом проекте нет, его создаёт php artisan install:api вместе с Sanctum и префиксом /api

Отсюда следствие, о котором спрашивают: глобальный middleware не знает маршрута. В нём нельзя спросить $request->route() и бесполезно проверять auth()->user() для сессионной авторизации: сессия стартует позже, в группе web. Глобально ставят то, что нужно всем запросам, включая несуществующие URL: доверенные прокси, CORS, режим обслуживания

Порядок внутри маршрута задаёт не только очередность в коде. Роутер сортирует middleware по списку приоритетов ($middleware->priority([...]), appendToPriorityList): например, StartSession всегда раньше auth, а SubstituteBindings раньше Authorize, иначе политике нечего было бы проверять. Убрать middleware группы с одного маршрута можно через withoutMiddleware, но только для middleware маршрута: глобальные так не снимаются

Ответ, send() и terminable middleware

Если у middleware есть метод terminate(Request $request, Response $response), Laravel вызовет его после того, как ответ ушёл клиенту. Это и называется terminable middleware. Типичные задачи: записать лог запроса с длительностью, отправить метрики

Механика под PHP-FPM такая. $response->send() (это Symfony HttpFoundation) пишет заголовки и тело, а затем вызывает fastcgi_finish_request(). FPM отдаёт ответ nginx и закрывает соединение с клиентом, браузер получает страницу. Но скрипт продолжает выполняться: дальше идёт $kernel->terminate(), и все terminate() отрабатывают уже без клиента. Воркер FPM в это время занят: если в terminate() ходить во внешний API на 2 секунды, пользователь этого не заметит, а пул заметит. На встроенном сервере php -S и других SAPI без fastcgi_finish_request клиент ждёт до конца terminate()

Ещё одна деталь из документации: для вызова terminate() Laravel заново достаёт middleware из контейнера, то есть это другой объект, не тот, что выполнял handle(). Нужен общий объект, например чтобы засечь время в handle и прочитать в terminate, — зарегистрируй middleware как singleton в register провайдера

Исключения

Исключение из middleware, роутера или контроллера ловит try/catch в Kernel::handle(): оно уходит в лог (report) и превращается в ответ (render). Ошибки HTTP вроде 404, 419 при неверном CSRF-токене и 403 при несовпадении origin по умолчанию не логируются. Настраивается всё в withExceptions: report() и render() для своих типов, dontReport(), level(), shouldRenderJsonWhen(), чтобы API отвечал JSON, а не HTML-страницей. Отдельного app/Exceptions/Handler.php с Laravel 11 нет

🛠️ На практике

bootstrap/app.php в актуальной структуре. Нет app/Http/Kernel.php и app/Console/Kernel.php: middleware, маршруты и исключения описаны здесь, планировщик живёт в routes/console.php:

<?php

use App\Http\Middleware\LogRequestDuration;
use App\Http\Middleware\EnsureUserIsSubscribed;
use Illuminate\Foundation\Application;
use Illuminate\Foundation\Configuration\Exceptions;
use Illuminate\Foundation\Configuration\Middleware;
use Illuminate\Http\Request;

return Application::configure(basePath: dirname(__DIR__))
    ->withRouting(
        web: __DIR__.'/../routes/web.php',
        api: __DIR__.'/../routes/api.php',          // появляется после install:api
        commands: __DIR__.'/../routes/console.php',
        health: '/up',
    )
    ->withMiddleware(function (Middleware $middleware): void {
        $middleware->append(LogRequestDuration::class);        // глобальный, в конец стека
        $middleware->alias(['subscribed' => EnsureUserIsSubscribed::class]); // короткое имя для маршрутов и атрибутов
    })
    ->withExceptions(function (Exceptions $exceptions): void {
        $exceptions->shouldRenderJsonWhen(
            fn (Request $request) => $request->is('api/*') || $request->expectsJson(),
        );
    })->create();

Порядок «до» и «после» удобно увидеть на модели пайплайна без фреймворка: три middleware и контроллер, собранные через array_reduce, как это делает Pipeline. На PHP 8.4 скрипт печатает TrustProxies до, StartSession до, auth до, контроллер, затем auth после, StartSession после, TrustProxies после. Первый в списке первым видит запрос и последним видит ответ

PHP · Модель пайплайна middleware

<?php
$mw = fn(string $n) => function ($req, Closure $next) use ($n) {
    echo "$n до\n";
    $r = $next($req);
    echo "$n после\n";
    return $r;
};
$stack = [$mw('TrustProxies'), $mw('StartSession'), $mw('auth')];
$core = function ($req) { echo "контроллер\n"; return 'ответ'; };

// оборачиваем с конца, чтобы первый middleware оказался снаружи
$pipeline = array_reduce(
    array_reverse($stack),
    fn($next, $m) => fn($req) => $m($req, $next),
    $core,
);
echo $pipeline('GET /orders/42'), "\n";

Terminable middleware, который пишет длительность запроса в лог. Без singleton в terminate() пришёл бы новый объект и $startedAt был бы пустым:

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Log;
use Symfony\Component\HttpFoundation\Response;

class LogRequestDuration
{
    private float $startedAt = 0.0;

    public function handle(Request $request, Closure $next): Response
    {
        $this->startedAt = microtime(true);

        return $next($request);
    }

    // вызывается после send(): клиент ответ уже получил, воркер FPM ещё занят
    public function terminate(Request $request, Response $response): void
    {
        Log::info('request', [
            'path' => $request->path(),
            'status' => $response->getStatusCode(),
            'ms' => (int) ((microtime(true) - $this->startedAt) * 1000),
        ]);
    }
}

// в AppServiceProvider::register():
// $this->app->singleton(LogRequestDuration::class);

Middleware на контроллере атрибутами, как в документации Laravel 13. Атрибут на методе сливается с атрибутом на классе, only и except ограничивают действия:

<?php

namespace App\Http\Controllers;

use App\Models\Order;
use Illuminate\Routing\Attributes\Controllers\Middleware;

#[Middleware('auth')]
#[Middleware('subscribed', except: ['index'])]
class OrderController
{
    public function index() { /* ... */ }

    #[Middleware('throttle:10,1')]
    public function show(Order $order) // {order} из URI → модель через SubstituteBindings
    {
        return $order; // модель станет JSON-ответом
    }
}

Кэши для прода

Под FPM каждый запрос поднимает приложение заново, поэтому всё, что фреймворк может не пересчитывать, лучше положить в файл в bootstrap/cache/, который OPcache держит в памяти:

КомандаЧто кладёт в кэшЧто экономит на каждом запросе
config:cacheвсе config/*.php одним массивом в bootstrap/cache/config.phpразбор .env и чтение десятков файлов конфигурации
route:cacheвсе маршруты в bootstrap/cache/routes-v7.phpвыполнение файлов routes/ и сборку коллекции маршрутов, заметно на сотнях маршрутов
event:cacheкарту событий и слушателейпоиск слушателей по каталогам
view:cacheскомпилированные шаблоны Bladeкомпиляцию шаблона при первом обращении
optimizeвсё перечисленное разом—

optimize запускают в деплое после установки зависимостей, optimize:clear сносит все эти файлы. Локально кэши не включают: поменял маршрут или конфиг — и не видишь изменений, пока не сбросишь кэш

⚠️ Где ошибаются

env() в коде приложения. В контроллере пишут env('PAYMENT_KEY'), локально работает. В проде деплой выполняет config:cache, бутстраппер LoadEnvironmentVariables видит закэшированную конфигурацию и .env не читает. Теперь env() возвращает только переменные окружения процесса, а для ключей из .env — null. Правильно: env() только в config/*.php, в коде config('services.payment.key')

Достают сервисы в register. $this->app->make(SomeClient::class) или фасад в register работает, пока провайдер стоит после нужного. Добавили пакет, порядок поменялся — ошибка «Target ... is not instantiable» или сервис с чужими настройками. Всё, кроме биндингов, переносится в boot

Тяжёлая работа в terminate(). Кажется, что раз ответ ушёл, то время бесплатное. Под FPM воркер занят до конца terminate(), и десяток таких запросов на пике съедает пул. Отправку писем и вызовы внешних API выноси в очередь, в terminate() оставляй короткое

Проверка авторизации в глобальном middleware. Глобальный стек работает до сессии и маршрута, auth()->user() при сессионном входе там пустой. Такой middleware ставят в группу web или на маршрут

Маршрут вне групп. Маршрут, зарегистрированный в then: или своём файле без ->middleware('web') или 'api', остаётся без SubstituteBindings. Тип Order $order в контроллере тогда не находит запись по {order}, а контейнер просто создаёт пустую модель. Ошибки нет, есть пустой ответ

🎯 Вопросы с собеседований

Опиши жизненный цикл запроса в Laravel

Веб-сервер направляет запрос в public/index.php. Тот подключает автозагрузчик и получает из bootstrap/app.php экземпляр приложения, то есть сервис-контейнер. handleRequest передаёт запрос HTTP-ядру Illuminate\Foundation\Http\Kernel, ядро запускает бутстрапперы: загрузку .env и конфигурации, обработчик ошибок, фасады, затем register и boot всех сервис-провайдеров. Дальше запрос идёт через глобальные middleware в роутер, роутер находит маршрут и пропускает запрос через middleware группы и маршрута, SubstituteBindings подставляет модели. Контроллер возвращает ответ, тот идёт обратно через middleware, send() отдаёт его клиенту, после чего terminate() вызывает terminable middleware

Чем register отличается от boot в сервис-провайдере?

Laravel сначала вызывает register у всех провайдеров, потом boot у всех. В register только регистрируют биндинги в контейнере, потому что другие провайдеры могут быть ещё не зарегистрированы и нужного сервиса может не быть. В boot уже доступно всё, поэтому там вешают слушатели событий, макросы, Route::bind, политики, и в параметры boot можно внедрять зависимости. Обращаться к другим сервисам внутри замыкания биндинга можно: оно выполнится при первом make, когда все провайдеры уже на месте

Что такое отложенный провайдер?

Провайдер, который реализует DeferrableProvider и перечисляет свои сервисы в provides(). Laravel запоминает этот список в bootstrap/cache/services.php и загружает провайдер только тогда, когда из контейнера просят один из этих сервисов. Это экономит время на каждом запросе, где сервис не нужен. Подходит только для провайдеров, которые регистрируют одни биндинги: слушатели и маршруты из такого провайдера не появятся, пока он не загружен

На каком этапе выполняются middleware? Чем глобальные отличаются от групповых?

Глобальные выполняет ядро на каждый запрос до поиска маршрута, даже для несуществующих URL: доверенные прокси, CORS, режим обслуживания. Групповые и middleware маршрута запускает роутер после того, как нашёл маршрут. Группа web даёт куки, сессию, CSRF и подстановку моделей, api — только подстановку моделей. Код до $next($request) выполняется на входе, после — на выходе с ответом, в обратном порядке. Всё настраивается в withMiddleware в bootstrap/app.php

Что такое terminable middleware и что происходит под PHP-FPM?

Middleware с методом terminate($request, $response), который Laravel вызывает после отправки ответа. Response::send() под FPM вызывает fastcgi_finish_request(): клиент получает ответ и соединение закрывается, а скрипт продолжает работать и выполняет terminate(). Пользователь не ждёт, но воркер FPM занят, пока terminate() не закончится, так что долгую работу туда класть нельзя, её место в очереди. Для terminate() Laravel берёт из контейнера новый экземпляр middleware, поэтому, если нужно состояние из handle(), middleware регистрируют как singleton

Зачем config:cache и почему после него env() возвращает null?

config:cache собирает все файлы config/ в один PHP-массив в bootstrap/cache/config.php. На каждом запросе фреймворк читает один файл из OPcache вместо разбора .env и десятков конфигов. Когда кэш есть, бутстраппер LoadEnvironmentVariables пропускает загрузку .env, и env() видит только настоящие переменные окружения процесса. Поэтому env() вызывают только внутри config/*.php, а в коде читают config('...'). В деплое его обычно запускают через php artisan optimize вместе с кэшем маршрутов, событий и шаблонов

📚 Что почитать

  • Request Lifecycle — официальное описание пути запроса от index.php до send()
  • Service Providers — register, boot, bootstrap/providers.php и отложенные провайдеры
  • Middleware — глобальный стек, группы web и api со списком классов, приоритеты и terminable middleware
  • Deployment — optimize и что делает каждая команда кэширования