Laravel Best Practices: Cách tách Validation và Authorization sang Form Request
- Home
- Laravel Best Practices: Cách tách Validation và Authorization sang Form Request
Khi dự án Laravel bắt đầu lớn dần, một trong những “điểm nóng” dễ phình to nhất chính là Controller. Nếu bạn đặt toàn bộ luật kiểm tra dữ liệu ($request->validate(...)) ngay bên trong từng action của Controller, code sẽ nhanh chóng trở nên dài dòng, khó đọc và khó tái sử dụng khi có nhiều endpoint cùng xử lý một kiểu dữ liệu.
Form Request trong Laravel ra đời để giải quyết triệt để vấn đề này: nó đóng gói toàn bộ logic authorization (phân quyền) và validation (kiểm tra dữ liệu) vào một class riêng biệt, giúp Controller giữ đúng vai trò điều phối luồng chính.
Controller gọn gàng, dễ đọc hơn: Controller chỉ nhận dữ liệu đã được đảm bảo hợp lệ và gọi Service/Repository/Model để xử lý nghiệp vụ.
Tái sử dụng luật validation: Nhiều route hoặc action (ví dụ: tạo mới và cập nhật, hoặc API và Web) có thể dùng chung hoặc kế thừa rules một cách rõ ràng.
Tách biệt phân quyền (authorize) và kiểm tra dữ liệu (rules): Dễ dàng kiểm soát ai có quyền thực hiện request trước cả khi chạy rule validate.
Tùy biến thông báo lỗi và chuẩn bị dữ liệu sạch: Hỗ trợ sẵn messages(), attributes(), và prepareForValidation() ngay trong class.
Chạy lệnh sau trong terminal để tạo một Form Request mới (ví dụ cho chức năng tạo bài viết):
Bash
php artisan make:request StorePostRequest
File mới sẽ được tạo tại app/Http/Requests/StorePostRequest.php với hai phương thức cốt lõi: authorize() và rules().
PHP
<?php
namespace App\Http\Requests;
use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Validation\Rule;
class StorePostRequest extends FormRequest
{
/**
* Xác định người dùng có quyền thực hiện request này hay không.
*/
public function authorize(): bool
{
return $this->user() !== null;
}
/**
* Chuẩn hóa dữ liệu trước khi validate (tùy chọn).
*/
protected function prepareForValidation(): void
{
if ($this->has('title')) {
$this->merge([
'title' => trim($this->input('title')),
]);
}
}
/**
* Các quy tắc kiểm tra dữ liệu.
*/
public function rules(): array
{
return [
'title' => ['required', 'string', 'max:255'],
'slug' => [
'required',
'string',
'max:255',
Rule::unique('posts', 'slug'),
],
'content' => ['required', 'string'],
'status' => ['required', Rule::in(['draft', 'published'])],
'published_at' => ['nullable', 'date'],
];
}
/**
* Tùy chỉnh thông báo lỗi tiếng Việt.
*/
public function messages(): array
{
return [
'title.required' => 'Vui lòng nhập tiêu đề bài viết.',
'title.max' => 'Tiêu đề không được vượt quá :max ký tự.',
'slug.unique' => 'Slug này đã tồn tại, vui lòng chọn slug khác.',
'status.in' => 'Trạng thái bài viết không hợp lệ.',
];
}
/**
* Đặt tên thân thiện cho các trường dữ liệu.
*/
public function attributes(): array
{
return [
'title' => 'tiêu đề',
'content' => 'nội dung',
'published_at' => 'ngày xuất bản',
];
}
}
Sau khi tạo xong StorePostRequest, bạn chỉ cần type-hint nó vào phương thức của Controller. Laravel sẽ tự động chạy authorize() và rules() trước khi vào thân hàm:
Nếu authorize() trả về false, Laravel tự động trả về lỗi 403 Forbidden.
Nếu validation thất bại, Laravel tự động redirect kèm lỗi (với web) hoặc trả về JSON 422 Unprocessable Entity (với request API / expectsJson()).
<?php
namespace App\Http\Controllers;
use App\Http\Requests\StorePostRequest;
use App\Models\Post;
use Illuminate\Http\RedirectResponse;
class PostController extends Controller
{
public function store(StorePostRequest $request): RedirectResponse
{
$validated = $request->validated();
$post = Post::create([
...$validated,
'user_id' => $request->user()->id,
]);
return redirect()
->route('posts.show', $post)
->with('success', 'Tạo bài viết thành công.');
}
}
Xử lý trường hợp Update (unique bỏ qua bản ghi hiện tại): Khi cập nhật bài viết, dùng Rule::unique('posts', 'slug')->ignore($this->route('post')) (hoặc truyền ID bản ghi) để tránh báo trùng chính slug của bài đang sửa.
Dùng $request->validated() thay vì $request->all(): Cách này giúp bạn chỉ lấy đúng những trường đã qua kiểm duyệt, hạn chế rủi ro mass-assignment ngoài ý muốn.
Đừng nhồi logic nghiệp vụ phức tạp vào Form Request: Form Request nên tập trung vào tính hợp lệ của dữ liệu đầu vào và quyền truy cập cơ bản; các quy tắc nghiệp vụ sâu (như kiểm tra số dư tài khoản, trạng thái đơn hàng theo luồng) nên nằm ở Service hoặc Policy/Gate tương ứng.
Tách validation sang Form Request là một bước cải thiện nhỏ nhưng mang lại hiệu quả lớn cho khả năng bảo trì codebase Laravel. Khi Controller nhẹ đi và mỗi Form Request mô tả rõ ràng “dữ liệu đầu vào thế nào là hợp lệ”, team của bạn sẽ đọc code nhanh hơn, test dễ hơn và mở rộng tính năng tự tin hơn.