Form Request class là gì?

Question

Accepted Answer

**Form Request** class là các class request tùy chỉnh **đóng gói logic validation (và authorization)** cho một request cụ thể. Chúng chuyển các quy tắc validation ra khỏi controller vào các class chuyên dụng, tái sử dụng — giữ controller mỏng và validation có tổ chức.

## Tạo và sử dụng một Form Request

```php
<?php
// php artisan make:request StoreUserRequest
class StoreUserRequest extends FormRequest {
    public function authorize(): bool {
        return $this->user()->can('create', User::class);   // kiểm tra AUTHORIZATION
    }

public function rules(): array {
        return [                                              // quy tắc VALIDATION
            'name' => 'required|string|max:100',
            'email' => 'required|email|unique:users',
            'password' => 'required|min:8|confirmed',
        ];
    }

public function messages(): array {
        return ['email.unique' => 'That email is already taken.'];   // thông báo tùy chỉnh
    }
}
```

```php
// type-hint Form Request trong controller — validation chạy TỰ ĐỘNG
public function store(StoreUserRequest $request) {
    // nếu đến được đây, validation VÀ authorization đã ĐẠT
    User::create($request->validated());   // lấy dữ liệu đã validate
}
```

Khi bạn type-hint một Form Request trong một method của controller, Laravel **tự động chạy authorization và validation của nó trước khi method thực thi** — nếu một trong hai thất bại, request bị từ chối (403 cho authorization, 422/redirect cho validation) và method của bạn không bao giờ chạy. Nên bên trong method, bạn biết dữ liệu hợp lệ và hành động được phép.

## Các lợi ích

```text
✓ Controller mỏng — logic validation/authorization nằm trong Form Request, không phải controller
✓ Tái sử dụng — dùng cùng một class request trên nhiều endpoint
✓ Có tổ chức — quy tắc, thông báo, và authorization cho một request ở một chỗ
✓ Kết hợp validation VÀ authorization — cả hai được kiểm tra tự động trước controller
✓ Truy cập dữ liệu đã chuẩn bị/validate gọn gàng qua $request->validated()
```

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

Form Request class là một thực hành tốt quan trọng của Laravel để tổ chức validation và authorization gọn gàng — chúng là cách tiếp cận được khuyến nghị cho bất cứ thứ gì vượt khỏi validation tầm thường, nên hiểu chúng có giá trị để viết các ứng dụng Laravel dễ bảo trì.

Lợi ích then chốt của chúng là giữ **controller mỏng**: bằng cách chuyển các quy tắc validation và logic authorization vào một class chuyên dụng (mà Laravel chạy tự động trước method của controller), controller tập trung vào logic cốt lõi của nó, với sự đảm bảo rằng dữ liệu đã được validate và hành động được phép khi nó thực thi.

Sự tách biệt này khiến code có tổ chức hơn (tất cả quy tắc, thông báo tùy chỉnh, và authorization cho một request ở một nơi gắn kết), tái sử dụng (cùng một Form Request có thể dùng trên các endpoint), và sạch sẽ hơn.

Việc kết hợp tự động **validation và authorization** trong một class — cả hai được kiểm tra trước khi controller chạy, tự động từ chối các request không hợp lệ hoặc không được phép — là thanh lịch và giảm boilerplate.

Hiểu Form Request, cách chúng chạy tự động, và lợi ích của việc tách validation/authorization khỏi controller phản ánh thực hành Laravel trưởng thành và quan trọng để xây dựng các ứng dụng có cấu trúc tốt, vì validation và authorization là các vấn đề phổ biến và Form Request là cách sạch sẽ, đúng phong cách của Laravel để xử lý chúng cho các trường hợp không tầm thường — một dấu hiệu của code Laravel chuyên nghiệp, dễ bảo trì.