LETUNOFF DOCS

Laravel. Controllers Api

🧱 Суть

Папка app/Http/Controllers/Api используется для хранения контроллеров, которые обслуживают API и возвращают JSON.

Laravel не требует создавать эту папку – это распространённая договорённость, которая помогает разделять контроллеры веб-интерфейса и API.

📦 Проблема

Если складывать все контроллеры в одну папку:

Controllers/
├── UserController
├── LoginController
├── ProductController
├── ApiUserController
├── ApiAuthController

со временем становится сложно ориентироваться в проекте.

✅ Решение

Разделять контроллеры по назначению.

Например:

app/
└── Http/
    └── Controllers/
            ├── Api/
            │     ├── UserController.php
            │     └── AuthController.php
            └── Web/
                ├── HomeController.php
                └── ProfileController.php

💻 Код

API-контроллер

Контроллер API обычно возвращает данные:

return User::all();

или

return response()->json($users);

Web-контроллер

Контроллер веб-приложения обычно возвращает HTML-представление:

return view('users');

🎯 Вывод

  • Controllers/Api – распространённая организация проекта
  • API-контроллеры обычно работают с JSON
  • Web-контроллеры обычно возвращают HTML
  • Laravel не навязывает такую структуру, но она считается хорошей практикой

🔗 Связано

Обратные ссылки