🔄 Жизненный цикл запроса в Laravel
Каждый HTTP-запрос в Laravel проходит один и тот же путь: public/index.php, создание приложения, HTTP-ядро, сервис-провайдеры, глобальные middleware, роутер, middleware маршрута, контроллер и обратно. Зная этот путь, понимаешь, куда положить проверку токена, почему биндинг из register не находит зависимость и почему после config:cache функция env() возвращает null. На собеседовании это один из первых вопросов по Laravel
Как запрос доходит от nginx до public/index.php, разобрано на странице «Путь запроса и PHP-FPM». Здесь начинаем с момента, когда воркер FPM открыл index.php
🧠 Как это устроено
Путь по шагам
public/index.phpзасекаетLARAVEL_START, проверяет файлstorage/framework/maintenance.php(если приложение в режиме обслуживания, ответ отдаётся ещё до загрузки фреймворка), подключает автозагрузчик Composerbootstrap/app.phpсоздаёт экземплярIlluminate\Foundation\Application. Это и есть сервис-контейнер. Сюда же черезApplication::configure()передаются маршруты, middleware и обработка исключенийindex.phpвызывает$app->handleRequest(Request::capture()). Приложение достаёт из контейнера HTTP-ядроIlluminate\Foundation\Http\Kernelи отдаёт ему запрос- Ядро запускает бутстрапперы по порядку:
LoadEnvironmentVariables(читает.env),LoadConfiguration(загружаетconfig/*.php),HandleExceptions,RegisterFacades,RegisterProviders,BootProviders. На двух последних шагах вызываютсяregisterиbootу всех провайдеров - Запрос проходит через глобальные middleware ядра:
TrustProxies,HandleCors,PreventRequestsDuringMaintenance,ValidatePostSize,TrimStrings,ConvertEmptyStringsToNullи другие - Роутер ищет маршрут. Нет совпадения — 404. Нашёл — собирает middleware маршрута: группу (
webилиapi), middleware самого маршрута и контроллера, сортирует их по списку приоритетов - Внутри группы
SubstituteBindingsпревращает{order}из URI в модельOrder(это и есть route model binding). Модели нет в базе — 404 - Контейнер создаёт контроллер, внедряет зависимости в конструктор и метод, вызывает действие
- Всё, что вернул контроллер (модель, массив, строку, view), роутер превращает в объект
Response, и тот идёт обратно через те же middleware в обратном порядке 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и что делает каждая команда кэширования