Validation (Xác thực dữ liệu)

Giới thiệu (Introduction)

Laravel cung cấp nhiều cách để validate incoming data. Phổ biến nhất là dùng method validate trên HTTP request object.

Validation nhanh (Quickstart)

Định nghĩa Routes

use App\Http\Controllers\PostController;

Route::get('/post/create', [PostController::class, 'create']);
Route::post('/post', [PostController::class, 'store']);

Viết Logic Validation

Dùng method validate trong controller:

<?php

namespace App\Http\Controllers;

use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\View\View;

class PostController extends Controller
{
    public function create(): View
    {
        return view('post.create');
    }

    public function store(Request $request): RedirectResponse
    {
        $validated = $request->validate([
            'title' => 'required|unique:posts|max:255',
            'body' => 'required',
        ]);

        // Dữ liệu đã validate hợp lệ...
        // Lưu bài viết...

        return redirect('/posts');
    }
}

Nếu validation fail, Laravel tự động redirect user về trang trước kèm error messages và old input.

Với XHR requests, trả JSON response với status 422 kèm validation errors.

Hiển thị Validation Errors

Biến $errors tự động có sẵn trong tất cả views (chia sẻ qua ShareErrorsFromSession middleware):

@if ($errors->any())
    <div class="alert alert-danger">
        <ul>
            @foreach ($errors->all() as $error)
                <li>{{ $error }}</li>
            @endforeach
        </ul>
    </div>
@endif

Directive @error:

<input id="title" type="text"
    class="@error('title') is-invalid @enderror">

@error('title')
    <div class="alert alert-danger">{{ $message }}</div>
@enderror

Repopulating Forms

Dùng old helper:

<input type="text" name="title" value="{{ old('title') }}">

Lưu ý về Optional Fields

Mặc định, Laravel bao gồm middleware TrimStrings và ConvertEmptyStringsToNull. Nếu field optional có thể null, đánh dấu nullable:

$request->validate([
    'title' => 'required|unique:posts|max:255',
    'body' => 'required',
    'publish_at' => 'nullable|date',
]);

Form Request Validation

Tạo Form Requests

php artisan make:request StorePostRequest

Class chứa methods authorize (kiểm tra quyền) và rules (quy tắc validation):

<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;

class StorePostRequest extends FormRequest
{
    public function authorize(): bool
    {
        return true; // hoặc kiểm tra quyền user
    }

    public function rules(): array
    {
        return [
            'title' => 'required|unique:posts|max:255',
            'body' => 'required',
        ];
    }
}

Sử dụng trong controller — type-hint trong method:

public function store(StorePostRequest $request): RedirectResponse
{
    // Request đã validate hợp lệ
    $validated = $request->validated();

    // Lưu bài viết...

    return redirect('/posts');
}

Tùy chỉnh Error Messages

public function messages(): array
{
    return [
        'title.required' => 'Tiêu đề bắt buộc nhập.',
        'body.required' => 'Nội dung bài viết bắt buộc nhập.',
    ];
}

Tùy chỉnh tên Attributes

public function attributes(): array
{
    return [
        'email' => 'địa chỉ email',
    ];
}

Chuẩn bị Input trước Validation

protected function prepareForValidation(): void
{
    $this->merge([
        'slug' => Str::slug($this->slug),
    ]);
}

Tạo Validator thủ công (Manually Creating Validators)

use Illuminate\Support\Facades\Validator;

$validator = Validator::make($request->all(), [
    'title' => 'required|unique:posts|max:255',
    'body' => 'required',
]);

if ($validator->fails()) {
    return redirect('/post/create')
        ->withErrors($validator)
        ->withInput();
}

$validated = $validator->validated();

After Validation Hook

$validator->after(function ($validator) {
    if ($this->somethingElseIsInvalid()) {
        $validator->errors()->add(
            'field', 'Có gì đó không đúng!'
        );
    }
});

Làm việc với Validated Input

$validated = $request->validated();     // array
$validated = $request->safe()->only(['name', 'email']);
$validated = $request->safe()->except(['password']);
$validated = $request->safe()->all();
$validated = $request->safe()->merge(['name' => 'Taylor']);

Các Validation Rules có sẵn

Laravel cung cấp hơn 100 validation rules tích hợp. Một số phổ biến:

Rule	Mô tả
required	Field bắt buộc
string	Phải là chuỗi
numeric	Phải là số
integer	Phải là số nguyên
email	Phải là email hợp lệ
min:value	Giá trị tối thiểu
max:value	Giá trị tối đa
unique:table,column	Duy nhất trong bảng DB
exists:table,column	Phải tồn tại trong bảng DB
confirmed	Field phải khớp với {field}_confirmation
date	Phải là ngày hợp lệ
array	Phải là array
file	Phải là file upload
image	Phải là ảnh (jpg, png, bmp, gif, svg, webp)
nullable	Cho phép null
boolean	Phải là true, false, 1, 0, "1", "0"
url	Phải là URL hợp lệ
json	Phải là JSON string hợp lệ

Xem danh sách đầy đủ trên trang docs gốc.

Custom Validation Rules

Sử dụng Rule Objects

php artisan make:rule Uppercase

<?php

namespace App\Rules;

use Closure;
use Illuminate\Contracts\Validation\ValidationRule;

class Uppercase implements ValidationRule
{
    public function validate(string $attribute, mixed $value, Closure $fail): void
    {
        if (strtoupper($value) !== $value) {
            $fail(':attribute phải viết hoa toàn bộ.');
        }
    }
}

Sử dụng:

use App\Rules\Uppercase;

$request->validate([
    'name' => ['required', 'string', new Uppercase],
]);

Sử dụng Closures

$request->validate([
    'title' => [
        'required',
        'max:255',
        function (string $attribute, mixed $value, Closure $fail) {
            if ($value === 'foo') {
                $fail("Giá trị {$attribute} không hợp lệ.");
            }
        },
    ],
]);

Validating Arrays

$request->validate([
    'person.*.email' => 'required|email|unique:users',
    'person.*.first_name' => 'required_with:person.*.last_name',
]);

Validating Files

$request->validate([
    'photo' => 'required|file|image|max:1024',
    'attachment' => 'required|file|mimes:jpg,png,pdf|max:2048',
]);

Validating Passwords

use Illuminate\Validation\Rules\Password;

$request->validate([
    'password' => ['required', 'confirmed', Password::defaults()],
]);

// Tùy chỉnh
$request->validate([
    'password' => ['required', 'confirmed', Password::min(8)
        ->letters()
        ->mixedCase()
        ->numbers()
        ->symbols()
        ->uncompromised()],
]);