В какой файл идет обращение из браузера в Laravel?

Механизм обработки запроса в Laravel: от браузера до контроллера

В стандартной структуре проекта Laravel, первоначальное обращение из браузера всегда идет к файлу **public/index.php**. Это ключевой единый входной пункт (entry point) для всех веб-запросов в приложении, что является фундаментальным принципом архитектуры Laravel и многих других современных PHP-фреймворков.

Почему именно public/index.php?

Стандартная структура папок Laravel включает:

laravel-project/
├── app/          # Основная логика приложения (контроллеры, модели)
├── bootstrap/    # Файлы начальной загрузки
├── config/       Конфигурации
├── database/     # Файлы базы данных
├── public/       # Публичная директория (единственная доступная из веб)
│   ├── index.php # Главный входной файл
│   ├── css/
│   ├── js/
│   └── ...
├── routes/       # Маршруты (web.php, api.php)
└── ...

Веб-сервер (Apache, Nginx) настроен так, что корневой директорией (root) для домена является именно папка public. Поэтому любой запрос (/, /users, /api/data) физически попадает сначала в public/index.php. Это обеспечивает контроль безопасности — основная кодовая база приложения (app/, config/) остается недоступной напрямую из интернета.

Что происходит внутри index.php?

Файл выполняет последовательную инициализацию приложения:

<?php
use Illuminate\Contracts\Http\Kernel;
use Illuminate\Http\Request;

define('LARAVEL_START', microtime(true));

// 1. Загрузка автозагрузчика классов Composer
require __DIR__.'/../vendor/autoload.php';

// 2. "Запуск" приложения: создание экземпляра Laravel app из bootstrap/app.php
$app = require_once __DIR__.'/../bootstrap/app.php';

// 3. Получение экземпляра HTTP Kernel (обработчик запросов)
$kernel = $app->make(Kernel::class);

// 4. Обработка входящего запроса через middleware и роутинг
$response = $kernel->handle(
    $request = Request::capture()
);

// 5. Отправка ответа клиенту (браузеру)
$response->send();

// 6. Завершение работы: выполнение пост/обработки
$kernel->terminate($request, $response);
?>

Дальнейший путь запроса после index.php

После инициализации в index.php, запрос проходит через последовательность слоев:

1. HTTP Kernel (App\Http\Kernel) — регистрирует глобальные middleware (проверка сессий, CSRF-токены для web-роутов).
2. Роутинг — система сопоставляет URL запроса с определением в файлах маршрутов (routes/web.php для веб, routes/api.php для API). Например:

   // routes/web.php
   Route::get('/profile', [ProfileController::class, 'show']);
   

3. Middleware маршрута — выполняются специфичные для данного маршрута промежуточные обработки (например, проверка аутентификации auth).
4. Контроллер (или замыкание) — конечная точка, где выполняется основная логика: работа с моделью, бизнес-правила, формирование ответа.

Особые случаи и альтернативные входные точки

• API запросы — также попадают в public/index.php, но затем обрабатываются через Api\Http\Kernel (имеет другой набор middleware, например, без CSRF) и маршруты из routes/api.php.
• Консольные команды (Artisan) — используют другой entry point: artisan файл в корне проекта, который запускает Console Kernel.
• Тесты — используют собственную инициализацию через phpunit.xml и тестовые среды.
• Статические файлы (CSS, JS, изображения из public/) — не попадают в index.php. Веб-сервер обслуживает их напрямую, если настроены соответствующие правила (например, в Nginx проверка существования файла до передачи в PHP-FPM).

Практическая важность понимания entry point

1. Размещение .htaccess (Apache) или правил Nginx — всегда в папке public/, чтобы правильно направлять запросы.
2. Деплой на сервере — необходимо указать public/ как корневую директорию в настройках веб-сервера.
3. Отладка проблем — если приложение не отвечает, проверка доступности public/index.php является первым шагом.
4. Безопасность — понимание, что только public/ публична, предотвращает попытки прямого доступа к конфигурационным файлам.

Таким образом, хотя конечная логика запроса реализуется в контроллерах глубоко внутри папки app/, физический путь любого HTTP-запроса из браузера в Laravel всегда начинается с файла public/index.php. Этот файл выступает как диспетчер, который запускает весь сложный механизм фреймворка для преобразования простого URL в полноценный ответ приложения.