Gratis update & dukungan instalasi

Tutorial Website 06 Nov 2026

Cara Membuat Validasi Form di Laravel dengan Form Request: Aturan, Pesan Bahasa Indonesia, dan Validasi Kustom (Panduan 2026)

R Oleh renz mobellgnd
Cara Membuat Validasi Form di Laravel dengan Form Request: Aturan, Pesan Bahasa Indonesia, dan Validasi Kustom (Panduan 2026)

Cara Membuat Validasi Form di Laravel dengan Form Request: Aturan, Pesan Bahasa Indonesia, dan Validasi Kustom (Panduan 2026)

Validasi form di Laravel paling rapi dibuat dengan Form Request: buat class khusus dengan php artisan make:request, tulis aturannya di method rules(), atur pesan Bahasa Indonesia di messages() dan attributes(), lalu type-hint class itu di controller — Laravel akan memvalidasi otomatis sebelum controller berjalan dan mengembalikan error ke form atau respons 422 untuk API.

Kalau selama ini aturan validasi menumpuk di controller, artikel ini memindahkannya ke tempat yang benar. Kita membangun contoh nyata: form tambah produk di toko online — nama, harga, stok, kategori, foto, dan deskripsi — lengkap dengan pesan error Bahasa Indonesia, otorisasi, validasi kondisional, aturan kustom, dan tampilan error di Blade. Contoh memakai gaya Laravel modern dan bisa langsung dicoba di Laravel 11/12/13.

Apa itu Form Request dan kapan sebaiknya dipakai?

Form Request adalah class khusus yang membungkus logika validasi dan otorisasi sebuah request. File-nya tinggal di app/Http/Requests/. Begitu controller menerima Form Request sebagai parameter, Laravel menjalankan otorisasi dan validasi sebelum method controller dieksekusi. Kalau gagal, pengguna dikembalikan ke form dengan error dan input lama; untuk request API, Laravel mengembalikan JSON 422.

Pakai Form Request ketika aturan dipakai di lebih dari satu tempat, formnya punya banyak field, atau ada logika otorisasi dan validasi kondisional. Untuk form satu field yang hanya dipakai sekali — misalnya kolom newsletter di footer — validasi inline $request->validate() di controller justru lebih praktis. Aturannya sederhana: satu tempat pemakaian dan aturan pendek, inline boleh; selebihnya, Form Request.

Perbandingan singkatnya:

Pendekatan Cocok untuk Kelemahan
$request->validate() di controllerForm kecil, sekali pakaiController gemuk, aturan sulit dipakai ulang
Form RequestForm besar, dipakai ulang, ada otorisasiSatu file tambahan per form
Rule object kustomAturan bisnis yang kompleksOverkill untuk aturan standar

Bagaimana cara membuat Form Request pertama?

Buat class-nya dengan Artisan:

php artisan make:request StoreProductRequest

Perintah ini membuat app/Http/Requests/StoreProductRequest.php dengan dua method penting: authorize() dan rules(). Ubah authorize() menjadi true (atau isi logika otorisasi, lihat bagian di bawah), lalu tulis aturannya:

<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;

class StoreProductRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}

public function rules(): array
{
return [
'name' => ['required', 'string', 'max:255'],
'price' => ['required', 'numeric', 'min:0'],
'stock' => ['required', 'integer', 'min:0'],
'category_id' => ['required', 'exists:categories,id'],
'photo' => ['nullable', 'image', 'max:2048'],
'description' => ['nullable', 'string', 'max:2000'],
];
}
}

Lalu pakai di controller. Perhatikan: tidak ada lagi blok validasi di controller, dan $request->validated() hanya mengembalikan field yang lolos aturan — field tambahan yang dikirim nakal dari luar form tidak akan ikut tersimpan:

<?php

namespace App\Http\Controllers;

use App\Http\Requests\StoreProductRequest;
use App\Models\Product;

class ProductController extends Controller
{
public function store(StoreProductRequest $request)
{
$product = Product::create($request->validated());

return redirect()->route('products.show', $product)
->with('success', 'Produk berhasil ditambahkan.');
}
}

Satu jebakan umum: authorize() bawaan bernilai false. Kalau lupa diubah, semua request ditolak dengan respons 403 padahal aturannya sudah benar. Kalau form boleh diakses semua pengguna yang login, kembalikan true; kalau hanya peran tertentu, isi dengan pengecekan peran — misalnya return $this->user()->can('create', Product::class); bila policy sudah dibuat. Dokumentasi resmi Laravel menjelaskan perilaku ini di halaman Validation, bagian Form Request Validation (laravel.com/docs/validation).

Bagaimana cara membuat pesan error Bahasa Indonesia yang rapi?

Secara default pesan error Laravel berbahasa Inggris dan menyebut nama field mentah, misalnya "The price field is required." Ada dua lapisan untuk memperbaikinya, dan keduanya sebaiknya dipakai bersamaan.

Pertama, attributes() mengganti nama field dengan label Bahasa Indonesia. Sekali ditulis, semua pesan untuk field itu otomatis memakai label tersebut:

public function attributes(): array
{
return [
'name' => 'nama produk',
'price' => 'harga',
'stock' => 'stok',
'category_id' => 'kategori',
'photo' => 'foto produk',
'description' => 'deskripsi',
];
}

Kedua, messages() menulis pesan per aturan. Pakai placeholder :attribute, :min, dan :max agar pesan tetap akurat tanpa ditulis ulang per field:

public function messages(): array
{
return [
'name.required' => ':attribute wajib diisi.',
'name.max' => ':attribute maksimal :max karakter.',
'price.required' => ':attribute wajib diisi.',
'price.numeric' => ':attribute harus berupa angka.',
'price.min' => ':attribute tidak boleh negatif.',
'stock.integer' => ':attribute harus berupa bilangan bulat.',
'category_id.exists' => ':attribute yang dipilih tidak valid.',
'photo.image' => ':attribute harus berupa file gambar.',
'photo.max' => 'Ukuran :attribute maksimal 2 MB.',
];
}

Hasilnya, pengguna melihat "Harga harus berupa angka." bukan "The price field must be a number." Untuk proyek berbahasa Indonesia sepenuhnya, alternatifnya adalah paket terjemahan laravel-lang/lang — tetapi dua method di atas sudah cukup untuk kebanyakan form tanpa menambah dependensi.

Bagaimana cara menangani validasi kondisional dan data sebelum validasi?

Tidak semua field selalu wajib. Contoh nyata: field discount_price hanya wajib bila produk sedang diskon, dan harga yang diketik pengguna sering memakai pemisah ribuan ("25.000") yang harus dibersihkan dulu. Dua fitur Form Request menangani ini.

prepareForValidation() berjalan sebelum aturan dicek — tempat yang tepat untuk normalisasi, bukan di controller:

protected function prepareForValidation(): void
{
$this->merge([
'price' => str_replace('.', '', $this->input('price', '')),
]);
}

Untuk aturan kondisional, pakai Rule::requiredIf() atau sometimes(). Contoh: harga diskon wajib dan harus lebih kecil dari harga normal hanya bila checkbox diskon dicentang:

use Illuminate\Validation\Rule;

public function rules(): array
{
return [
'price' => ['required', 'numeric', 'min:0'],
'is_discount' => ['sometimes', 'boolean'],
'discount_price' => [
Rule::requiredIf($this->boolean('is_discount')),
'nullable', 'numeric', 'lt:price',
],
];
}

Aturan lt:price memastikan harga diskon selalu di bawah harga normal — validasi antar-field seperti ini sulit ditulis rapi bila aturan tersebar di controller. Tambahkan bail di awal daftar aturan sebuah field bila ingin validasi berhenti di error pertama field itu, misalnya ['bail', 'required', 'numeric'], supaya pengguna tidak dibanjiri tiga pesan sekaligus untuk satu field yang kosong.

Bagaimana cara membuat aturan validasi kustom?

Bila aturannya menyangkut logika bisnis — misalnya kode SKU harus mengikuti pola tertentu — jangan menjejalkannya ke controller. Buat Rule object:

php artisan make:rule ValidSku
<?php

namespace App\Rules;

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

class ValidSku implements ValidationRule
{
public function validate(string $attribute, mixed $value, Closure $fail): void
{
if (! preg_match('/^[A-Z]{3}-\d{4}$/', $value)) {
$fail('Format :attribute harus seperti PRD-0001 (3 huruf kapital, strip, 4 angka).');
}
}
}

Pakai di Form Request seperti aturan biasa:

use App\Rules\ValidSku;

'sku' => ['required', 'string', 'unique:products,sku', new ValidSku],

Untuk aturan sekali pakai yang sangat pendek, closure di dalam rules() juga sah — tetapi Rule object lebih mudah diuji dan dipakai ulang. Satu catatan: validasi bukan satu-satunya penjaga. Kombinasikan dengan constraint unique di database untuk data yang tidak boleh ganda, karena dua request bersamaan bisa sama-sama lolos validasi sebelum salah satunya tersimpan.

Bagaimana cara menampilkan error di Blade dan menangani API?

Di Blade, Laravel menyediakan variabel $errors dan directive @error. Pola yang rapi: tampilkan pesan di bawah field, kembalikan input lama dengan old(), dan tandai field yang error:

<div>
<label for="name">Nama Produk</label>
<input id="name" name="name" value="{{ old('name') }}"
class="@error('name') border-red-500 @enderror">
@error('name')
<p class="text-red-600 text-sm">{{ $message }}</p>
@enderror
</div>

Jangan lupa @csrf di dalam tag <form> — tanpanya Laravel menolak request dengan error 419. Untuk API, tidak ada yang perlu diubah: bila request mengirim header Accept: application/json, Laravel otomatis mengembalikan JSON 422 berisi daftar error per field. Pola ini sama dengan autentikasi API Sanctum di artikel Cara Membuat Autentikasi API Laravel dengan Sanctum untuk Aplikasi Mobile.

Validasi juga relevan dengan form lain yang sudah dibahas di KiosKoding: form lupa password di artikel Cara Membuat Fitur Lupa Password di Laravel memakai pola Form Request yang sama untuk email reset, dan form upload di artikel Cara Upload File di Laravel mengandalkan aturan image dan max agar file yang masuk aman. Bila form menerima input dari bot, lapisi lagi dengan reCAPTCHA seperti di artikel Cara Menambahkan Google reCAPTCHA v3 di Laravel — validasi memastikan datanya benar, reCAPTCHA memastikan pengirimnya manusia.

Checklist sebelum Form Request naik ke produksi

  1. authorize() sudah benar — bukan false bawaan yang tertinggal.
  2. Semua field memakai attributes() Bahasa Indonesia, bukan nama kolom mentah.
  3. Controller memakai $request->validated(), bukan $request->all().
  4. Aturan unique punya pasangan unique constraint di database untuk data kritis.
  5. Batas upload (max, mimes/image) sudah diset agar sesuai limit server.
  6. Pesan error sudah dicoba dengan input kosong, format salah, dan duplikat.
  7. Respons API (422) sudah dicoba dengan header Accept: application/json.

Cara ini tidak cocok jika aturan validasi berubah-ubah total berdasarkan konfigurasi runtime yang kompleks — dalam kasus itu Validator manual dengan array aturan yang dibangun dinamis di service class lebih fleksibel daripada Form Request statis. Untuk 90% form aplikasi web dan API, Form Request adalah titik tengah yang paling enak dirawat.

FAQ

Apakah Form Request wajib untuk semua form di Laravel?

Tidak. Form kecil sekali pakai cukup memakai $request->validate() di controller. Form Request baru sepadan ketika formnya besar, dipakai ulang, atau butuh otorisasi dan aturan kondisional.

Kenapa request saya selalu 403 padahal aturannya benar?

Hampir pasti karena method authorize() masih mengembalikan false bawaan dari Artisan. Ubah menjadi true atau isi dengan pengecekan hak akses yang sesuai.

Bagaimana cara menampilkan semua error, bukan hanya satu per field?

Secara default Blade menampilkan satu pesan per pemanggilan @error. Untuk semua pesan sebuah field, loop $errors->get('email') di Blade.

Apakah validasi Form Request juga berlaku untuk API?

Ya. Bila request mengirim Accept: application/json, Laravel mengembalikan JSON dengan status 422 dan daftar error per field, tanpa redirect.

Apakah $request->validated() aman dari field tambahan yang dikirim nakal?

Ya, sejauh field itu tidak ada di rules(). Field di luar aturan tidak masuk hasil validated(), sehingga tidak ikut tersimpan bila controller memakai method tersebut.

Kapan memakai Rule object dan kapan cukup closure?

Rule object untuk aturan yang dipakai ulang atau perlu unit test sendiri. Closure cukup untuk aturan sekali pakai yang pendek dan spesifik satu form.

Apakah validasi menggantikan constraint unique di database?

Tidak. Validasi mencegah input buruk, tetapi hanya unique constraint di database yang menjamin tidak ada duplikat saat dua request datang bersamaan.