Controller trong Laravel là gì?

Question

Accepted Answer

**Controller** nhóm các logic xử lý request liên quan vào các class. Thay vì đặt tất cả logic trong route closure, controller tổ chức các hành động của ứng dụng (ví dụ tất cả thao tác liên quan đến user) vào các method — giữ route gọn gàng và code có tổ chức.

## Một controller cơ bản

```php
<?php
class UserController extends Controller {
    public function index() {
        return User::all();              // liệt kê user
    }
    public function show(User $user) {   // route model binding — tự động lấy theo id
        return $user;
    }
    public function store(Request $request) {
        $validated = $request->validate(['name' => 'required', 'email' => 'required|email']);
        return User::create($validated);  // tạo mới
    }
}
```

Sinh một controller bằng Artisan: `php artisan make:controller UserController`. Mỗi method xử lý một hành động, và các route trỏ tới chúng.

## Resource controller (CRUD theo RESTful)

```php
// sinh một controller với cả 7 method RESTful được tạo khung sẵn
// php artisan make:controller PostController --resource

Route::resource('posts', PostController::class);   // ánh xạ route tới các method:
// index() create() store() show() edit() update() destroy()
```

Một **resource controller** có các method CRUD chuẩn, kết hợp với `Route::resource` để định tuyến RESTful theo quy ước — boilerplate tối thiểu cho các resource CRUD điển hình.

## Dependency injection trong controller

```php
class OrderController extends Controller {
    // các dependency được type-hint sẽ được service container TỰ ĐỘNG INJECT
    public function __construct(private OrderService $orders) {}

public function store(Request $request, Mailer $mailer) {   // cả method injection nữa
        // $request và $mailer được resolve & inject tự động
    }
}
```

Service container của Laravel **tự động inject** các dependency được type-hint vào constructor và method của controller (bao gồm cả `Request`) — code sạch sẽ, dễ test.

## Giữ controller mỏng

```text
✓ Controller nên xử lý các vấn đề HTTP (validate input, gọi service, trả về response)
✗ Business logic thuộc về SERVICE/model, không phải controller phình to ("thin controllers")
```

## Tại sao điều này quan trọng

Controller là một thành phần cốt lõi của Laravel — chúng tổ chức logic xử lý request vào các class gắn kết, điều thiết yếu cho bất kỳ ứng dụng nào vượt khỏi các route tầm thường.

Hiểu cách tạo controller, ánh xạ route tới các method của chúng, và đặc biệt là dùng **resource controller** với `Route::resource` (cho CRUD RESTful theo quy ước với boilerplate tối thiểu) là kiến thức hằng ngày để xây dựng ứng dụng Laravel.

Một tính năng then chốt của Laravel là **dependency injection tự động** vào controller thông qua service container — các dependency được type-hint (service, request, mailer) được resolve và inject tự động, cho phép code sạch sẽ, dễ test, ít ràng buộc chặt.

Quan trọng không kém là thực hành tốt giữ controller **mỏng** — chỉ xử lý các vấn đề HTTP (validation, gọi service, trả về response) và ủy thác business logic cho service/model, điều giữ code dễ bảo trì và dễ test.

Controller, cùng với routing và model, tạo nên xương sống của việc xử lý request trong Laravel, khiến chúng nền tảng để xây dựng các ứng dụng Laravel được tổ chức tốt, chuyên nghiệp.