Validasi adalah garis pertahanan pertama terhadap data rusak dan input berbahaya. Panduan ini membahas Form Request, normalisasi input, aturan bersyarat, array bertingkat, validasi yang sadar hak akses, aturan password, custom rule, pesan berbahasa Indonesia, dan cara mengujinya.
Overview
Validasi sering dianggap urusan UX: memberi tahu pengguna bahwa kolom wajib belum diisi. Padahal validasi di server adalah kontrol keamanan. Contoh masalah yang muncul ketika validasi lemah:
- Warga mengirim
keluarga_idmilik keluarga lain lewat field tersembunyi, dan aplikasi menerimanya. - Jumlah iuran negatif lolos dan saldo kas menjadi kacau.
- Kolom
role=adminikut terkirim dan tersimpan karena controller memakai$request->all(). - Nomor HP disimpan dalam lima format berbeda, sehingga pencarian dan notifikasi gagal.
- Array
itemsberisi 10.000 elemen dan membuat server kehabisan memori.
Validasi di browser (HTML5 required, JavaScript) bisa dilewati dengan mudah. Hanya validasi di server yang bisa dipercaya.
Hasil akhir:
- Form Request untuk setiap aksi yang menerima input,
- normalisasi input sebelum divalidasi,
- aturan bersyarat dan validasi array bertingkat dengan batas ukuran,
- validasi
existsyang dibatasi hak akses pengguna, - aturan password yang kuat dan terpusat,
- custom rule yang dapat dipakai ulang dan diuji,
- pesan error berbahasa Indonesia,
- test untuk aturan validasi.
Prerequisites
| Komponen | Versi |
|---|---|
| PHP | 8.3+ (disarankan 8.4) |
| Laravel | 13.x |
| Database | MySQL 8.0+ / PostgreSQL 15+ |
| Testing | Pest 4 |
Contoh memakai aplikasi RW dari artikel Role-Based Access Control di Laravel.
Step-by-step Tutorial
Langkah 1: Selalu Gunakan Form Request untuk Input Penting
php artisan make:request StoreKeluargaRequest
// app/Http/Requests/StoreKeluargaRequest.php
namespace App\Http\Requests;
use App\Models\Keluarga;
use Illuminate\Foundation\Http\FormRequest;
class StoreKeluargaRequest extends FormRequest
{
public function authorize(): bool
{
return $this->user()->can('create', Keluarga::class);
}
public function rules(): array
{
return [
'nomor_kk' => ['required', 'digits:16', 'unique:keluarga,nomor_kk'],
'alamat' => ['required', 'string', 'max:255'],
'rukun_tetangga_id' => ['required', 'integer', 'exists:rukun_tetangga,id'],
];
}
}
// Controller
public function store(StoreKeluargaRequest $request)
{
$keluarga = Keluarga::create($request->validated()); // hanya field yang tervalidasi
return redirect()->route('keluarga.show', $keluarga);
}
Prinsip yang tidak bisa ditawar: simpan hanya validated() atau safe(), jangan $request->all() atau $request->input(). Field yang tidak ada di rules() otomatis tidak ikut, sehingga field liar seperti role atau is_active tidak pernah sampai ke database.
$request->validated(); // array semua field tervalidasi
$request->safe()->only(['alamat']); // subset
$request->safe()->except(['lampiran']);
$request->validated('alamat'); // satu field
Langkah 2: Normalisasi Input Sebelum Divalidasi
Data dari pengguna datang dalam berbagai format. Rapikan dulu, baru validasi, sehingga aturan dan penyimpanan konsisten.
// app/Http/Requests/StoreWargaRequest.php
use Illuminate\Support\Str;
protected function prepareForValidation(): void
{
$this->merge([
'nama' => Str::squish((string) $this->nama), // spasi berlebih
'nik' => preg_replace('/\D/', '', (string) $this->nik), // buang spasi/titik
'no_hp' => $this->normalisasiHp((string) $this->no_hp),
'email' => $this->email ? Str::lower(trim($this->email)) : null,
]);
}
private function normalisasiHp(string $hp): ?string
{
$digit = preg_replace('/\D/', '', $hp);
return match (true) {
$digit === '' => null,
str_starts_with($digit, '62') => '+'.$digit,
str_starts_with($digit, '0') => '+62'.substr($digit, 1),
str_starts_with($digit, '8') => '+62'.$digit,
default => $digit,
};
}
public function rules(): array
{
return [
'nama' => ['required', 'string', 'min:2', 'max:100'],
'nik' => ['required', 'digits:16'],
'no_hp' => ['nullable', 'regex:/^\+628\d{7,11}$/'],
'email' => ['nullable', 'email:rfc', 'max:255'],
];
}
Input 0812-3456 7890, +62 812 3456 7890, dan 812345678 90 semuanya tersimpan sebagai +6281234567890.
Normalisasi bukan pengganti escaping output. Data tetap harus di-escape saat ditampilkan (lihat artikel Mencegah SQL Injection, Cross-Site Scripting, dan CSRF).
Langkah 3: Aturan yang Sadar Hak Akses
Aturan exists:keluarga,id hanya memeriksa bahwa ID ada, bukan bahwa pengguna berhak memakainya. Pengurus RT 001 bisa mengirim ID keluarga dari RT 005 dan lolos.
use Illuminate\Validation\Rule;
public function rules(): array
{
$user = $this->user();
return [
'keluarga_id' => [
'required', 'integer',
Rule::exists('keluarga', 'id')->where(function ($query) use ($user) {
if (! $user->hasAnyRole(['admin', 'bendahara'])) {
$query->where('rukun_tetangga_id', $user->rukun_tetangga_id ?? 0);
}
}),
],
'periode' => ['required', 'date_format:Y-m', 'before_or_equal:'.now()->format('Y-m')],
'jumlah' => ['required', 'integer', 'min:1000', 'max:10000000'],
];
}
Pesan error untuk ID di luar cakupan sama dengan ID yang tidak ada (keluarga_id tidak valid), sehingga tidak membocorkan informasi.
Untuk warga, jangan menerima keluarga_id sama sekali; isi dari pengguna yang login:
$data = [...$request->validated(), 'keluarga_id' => $request->user()->keluarga_id];
Langkah 4: Aturan Bersyarat
// app/Http/Requests/StoreTransaksiKasRequest.php
use App\Enums\JenisKas;
use Illuminate\Validation\Rule;
public function rules(): array
{
return [
'jenis' => ['required', Rule::enum(JenisKas::class)],
'jumlah' => ['required', 'integer', 'min:1', 'max:1000000000'],
'keterangan' => ['required', 'string', 'max:255'],
'tanggal' => ['required', 'date', 'before_or_equal:today'],
// Pengeluaran wajib menyertakan bukti dan penerima
'penerima' => ['exclude_unless:jenis,keluar', 'required', 'string', 'max:100'],
'bukti' => ['exclude_unless:jenis,keluar', 'required', 'file', 'mimes:jpg,jpeg,png,pdf', 'max:4096'],
// Kategori hanya relevan untuk pemasukan
'sumber' => [Rule::requiredIf($this->input('jenis') === 'masuk'), 'nullable', 'string', 'max:50'],
];
}
| Aturan | Perilaku |
|---|---|
required_if:jenis,keluar |
Wajib bila kondisi terpenuhi; bila tidak, field tetap ikut divalidasi oleh aturan lain |
exclude_unless:jenis,keluar |
Bila kondisi tidak terpenuhi, field dibuang dari hasil validated() dan aturan lain diabaikan |
Rule::requiredIf(fn) |
Kondisi berupa kode PHP |
sometimes |
Validasi hanya bila field dikirim (berguna untuk PATCH) |
prohibited_unless |
Field dilarang dikirim kecuali kondisi terpenuhi |
exclude_* lebih aman daripada required_if untuk field yang tidak relevan, karena field tersebut tidak akan pernah tersimpan walaupun dikirim.
Langkah 5: Validasi Array dengan Batas Ukuran
Input array tanpa batas adalah vektor denial of service. Selalu batasi jumlah elemen.
// Pencatatan iuran massal untuk satu RT
public function rules(): array
{
return [
'pembayaran' => ['required', 'array', 'min:1', 'max:100'],
'pembayaran.*.keluarga_id' => ['required', 'integer', 'distinct', Rule::exists('keluarga', 'id')
->where('rukun_tetangga_id', $this->user()->rukun_tetangga_id)],
'pembayaran.*.jumlah' => ['required', 'integer', 'min:1000', 'max:10000000'],
'pembayaran.*.catatan' => ['nullable', 'string', 'max:255'],
];
}
public function attributes(): array
{
return [
'pembayaran.*.keluarga_id' => 'keluarga pada baris ke-:position',
'pembayaran.*.jumlah' => 'jumlah pada baris ke-:position',
];
}
max:100membatasi jumlah baris.distinctmencegah keluarga yang sama dicatat dua kali dalam satu kiriman.- Placeholder
:position(berbasis 1) membuat pesan error menunjuk baris yang tepat.
Untuk array yang sangat besar, exists per elemen menghasilkan satu query per baris. Pada kasus ini, validasi keberadaan secara massal di method after() (Langkah 7) lebih efisien.
Langkah 6: Aturan Password Terpusat
Definisikan aturan password sekali, lalu pakai di registrasi, reset, dan ganti password:
// app/Providers/AppServiceProvider.php
use Illuminate\Validation\Rules\Password;
public function boot(): void
{
Password::defaults(function () {
$rule = Password::min(10)->letters()->mixedCase()->numbers();
return $this->app->isProduction()
? $rule->uncompromised() // tolak password yang pernah bocor
: $rule;
});
}
// Pemakaian
'password' => ['required', 'confirmed', Password::defaults()],
'current_password' => ['required', 'current_password'], // cocokkan password saat ini
uncompromised() memeriksa password ke basis data kebocoran Have I Been Pwned dengan metode k-anonymity: hanya 5 karakter awal hash SHA-1 yang dikirim, bukan password itu sendiri. Aturan ini memerlukan koneksi keluar dari server; karena itu contoh di atas hanya mengaktifkannya di production.
Panjang lebih penting daripada kerumitan. Password 10–12 karakter yang tidak pernah bocor lebih kuat daripada P@ssw0rd! yang memenuhi semua syarat karakter.
Langkah 7: Validasi Lintas Field dengan after()
Beberapa aturan melibatkan beberapa field atau data di database. Gunakan method after() pada Form Request:
use Illuminate\Validation\Validator;
public function after(): array
{
return [
function (Validator $validator) {
if ($validator->errors()->isNotEmpty()) {
return; // jangan query bila validasi dasar gagal
}
$sudahBayar = Iuran::query()
->whereIn('keluarga_id', collect($this->pembayaran)->pluck('keluarga_id'))
->where('periode', $this->periode)
->whereNotNull('dibayar_pada')
->pluck('keluarga_id');
foreach ($this->pembayaran as $i => $baris) {
if ($sudahBayar->contains($baris['keluarga_id'])) {
$validator->errors()->add(
"pembayaran.{$i}.keluarga_id",
'Keluarga ini sudah membayar iuran periode '.$this->periode.'.'
);
}
}
},
];
}
Satu query untuk seluruh baris, bukan satu query per baris.
Validasi seperti ini mengurangi kesalahan, tetapi tidak menjamin bebas race condition bila dua admin mengirim bersamaan. Pertahankan juga indeks unik di database (
unique(['keluarga_id', 'periode'])) sebagai pengaman terakhir.
Langkah 8: Custom Rule yang Dapat Dipakai Ulang
Aturan yang dipakai di banyak Form Request sebaiknya menjadi class tersendiri.
php artisan make:rule NomorKkValid
// app/Rules/NomorKkValid.php
namespace App\Rules;
use Closure;
use Illuminate\Contracts\Validation\ValidationRule;
class NomorKkValid implements ValidationRule
{
public function validate(string $attribute, mixed $value, Closure $fail): void
{
if (! is_string($value) || ! preg_match('/^\d{16}$/', $value)) {
$fail('Nomor KK harus terdiri dari 16 digit angka.');
return;
}
// 6 digit pertama: kode wilayah (provinsi, kabupaten/kota, kecamatan)
$kodeProvinsi = (int) substr($value, 0, 2);
if ($kodeProvinsi < 11 || $kodeProvinsi > 99) {
$fail('Kode wilayah pada nomor KK tidak valid.');
return;
}
// Digit 7–12: tanggal penerbitan DDMMYY
$hari = (int) substr($value, 6, 2);
$bulan = (int) substr($value, 8, 2);
if ($hari < 1 || $hari > 31 || $bulan < 1 || $bulan > 12) {
$fail('Tanggal pada nomor KK tidak valid.');
}
}
}
'nomor_kk' => ['required', new NomorKkValid, 'unique:keluarga,nomor_kk'],
Pemeriksaan struktur seperti ini menangkap salah ketik, tetapi tidak membuktikan bahwa nomor KK itu nyata. Jangan menjadikannya satu-satunya dasar keputusan penting.
Rule yang membutuhkan nilai field lain bisa mengimplementasikan DataAwareRule:
// app/Rules/TidakMelebihiSaldo.php
namespace App\Rules;
use App\Services\SaldoKas;
use Closure;
use Illuminate\Contracts\Validation\{DataAwareRule, ValidationRule};
class TidakMelebihiSaldo implements ValidationRule, DataAwareRule
{
protected array $data = [];
public function setData(array $data): static
{
$this->data = $data;
return $this;
}
public function validate(string $attribute, mixed $value, Closure $fail): void
{
if (($this->data['jenis'] ?? null) !== 'keluar') {
return;
}
$saldo = app(SaldoKas::class)->saatIni();
if ((int) $value > $saldo) {
$fail('Pengeluaran melebihi saldo kas saat ini (Rp '.number_format($saldo, 0, ',', '.').').');
}
}
}
Langkah 9: Pesan Error Berbahasa Indonesia
Publikasikan file bahasa, lalu buat terjemahan Indonesia:
php artisan lang:publish
// config/app.php (atau .env APP_LOCALE=id)
'locale' => env('APP_LOCALE', 'id'),
'fallback_locale' => 'en',
Salin lang/en/validation.php menjadi lang/id/validation.php dan terjemahkan, atau gunakan paket komunitas terjemahan Laravel. Contoh sebagian:
// lang/id/validation.php
return [
'required' => ':Attribute wajib diisi.',
'digits' => ':Attribute harus terdiri dari :digits digit.',
'unique' => ':Attribute sudah terdaftar.',
'exists' => ':Attribute yang dipilih tidak valid.',
'max' => [
'string' => ':Attribute maksimal :max karakter.',
'file' => 'Ukuran :attribute maksimal :max kilobyte.',
'array' => ':Attribute maksimal berisi :max item.',
],
// ...
'attributes' => [
'nomor_kk' => 'nomor KK',
'no_hp' => 'nomor HP',
'nik' => 'NIK',
],
];
Nama atribut khusus per form tetap bisa ditimpa di method attributes() Form Request, dan pesan per aturan di method messages().
Langkah 10: Respons Validasi untuk API
Untuk request dengan header Accept: application/json, Laravel otomatis mengembalikan status 422:
{
"message": "Nomor KK wajib diisi. (dan 1 kesalahan lainnya)",
"errors": {
"nomor_kk": ["Nomor KK wajib diisi."],
"rukun_tetangga_id": ["RT yang dipilih tidak valid."]
}
}
Beberapa opsi berguna:
class StoreKeluargaRequest extends FormRequest
{
protected $stopOnFirstFailure = true; // berhenti di field pertama yang gagal (hemat query)
}
'nomor_kk' => ['bail', 'required', new NomorKkValid, 'unique:keluarga,nomor_kk'],
// bail: aturan berikutnya untuk field ini tidak dijalankan bila satu aturan gagal
Gunakan bail sebelum aturan yang memerlukan query (unique, exists) agar database tidak di-query untuk input yang formatnya saja sudah salah.
Langkah 11: Uji Aturan Validasi
// tests/Unit/Rules/NomorKkValidTest.php
use App\Rules\NomorKkValid;
use Illuminate\Support\Facades\Validator;
it('menilai nomor KK', function (string $nilai, bool $lolos) {
$v = Validator::make(['kk' => $nilai], ['kk' => [new NomorKkValid]]);
expect($v->passes())->toBe($lolos);
})->with([
'valid' => ['3276011503250001', true],
'kurang digit' => ['327601150325', false],
'mengandung huruf' => ['32760115032500AB', false],
'kode provinsi salah' => ['0076011503250001', false],
'bulan 13' => ['3276011513250001', false],
]);
// tests/Feature/Validation/IuranMassalTest.php
it('pengurus tidak bisa mencatat iuran keluarga di luar RT-nya', function () {
$this->seed(\Database\Seeders\RolePermissionSeeder::class);
$rt1 = RukunTetangga::factory()->create();
$pengurus = User::factory()->create(['rukun_tetangga_id' => $rt1->id])->assignRole('pengurus');
$keluargaLain = Keluarga::factory()->create(); // RT lain
$this->actingAs($pengurus)
->postJson('/iuran/massal', [
'periode' => now()->format('Y-m'),
'pembayaran' => [['keluarga_id' => $keluargaLain->id, 'jumlah' => 20000]],
])
->assertUnprocessable()
->assertJsonValidationErrors('pembayaran.0.keluarga_id');
});
it('menolak lebih dari 100 baris', function () {
// ... siapkan pengurus seperti di atas
$this->actingAs($pengurus)
->postJson('/iuran/massal', ['periode' => '2026-10', 'pembayaran' => array_fill(0, 101, ['keluarga_id' => 1, 'jumlah' => 1000])])
->assertJsonValidationErrors('pembayaran');
});
it('field liar tidak tersimpan', function () {
$admin = User::factory()->create()->assignRole('admin');
$this->actingAs($admin)->post('/keluarga', [
'nomor_kk' => '3276011503250001', 'alamat' => 'Jl. Melati 1',
'rukun_tetangga_id' => RukunTetangga::factory()->create()->id,
'id' => 999, 'created_at' => '2000-01-01',
]);
expect(Keluarga::first())->id->not->toBe(999)
->created_at->year->toBe(now()->year);
});
Troubleshooting
| Error / Gejala | Penyebab | Solusi |
|---|---|---|
validated() tidak berisi field yang dikirim |
Field tidak tercantum di rules() |
Tambahkan aturan (minimal nullable) untuk field yang memang boleh diterima |
| Validasi lolos tetapi data yang tersimpan berbeda | Normalisasi dilakukan setelah validasi | Pindahkan ke prepareForValidation() |
exists lolos untuk data di luar hak akses |
exists hanya memeriksa keberadaan |
Gunakan Rule::exists()->where(...) sesuai cakupan pengguna |
| Pesan error masih berbahasa Inggris | Locale atau file bahasa belum diatur | php artisan lang:publish, buat lang/id/validation.php, set APP_LOCALE=id |
uncompromised() lambat atau gagal di server tanpa internet |
Aturan memanggil layanan eksternal | Aktifkan hanya di production yang punya akses keluar; tangani timeout |
| Ratusan query saat memvalidasi array | exists / unique per elemen |
Validasi massal di after() dengan satu query |
| Field kondisional tetap tersimpan walaupun tidak relevan | Memakai required_if saja |
Gunakan exclude_if / exclude_unless |
403 This action is unauthorized sebelum validasi berjalan |
authorize() mengembalikan false |
Ini perilaku yang benar; otorisasi diperiksa sebelum validasi |
Best Practices
Keamanan
- Validasi di server untuk setiap input, termasuk input dari aplikasi mobile dan integrasi internal.
- Simpan hanya
validated()/safe(); jangan pernahall(). - Batasi ukuran semua input: panjang string (
max), jumlah elemen array, ukuran file. - Gunakan
Rule::exists()->where()agar referensi ID dibatasi hak akses pengguna. - Untuk nilai milik pengguna (seperti
keluarga_idwarga), ambil dari sesi, bukan dari input. - Pertahankan constraint database (unik, foreign key,
NOT NULL) sebagai pengaman terakhir.
Performa
bailsebelum aturan yang melakukan query.- Validasi massal satu query di
after()untuk array besar. stopOnFirstFailureuntuk endpoint API dengan aturan mahal.
Maintainability
- Satu Form Request per aksi (
Store,Update), walaupun aturannya mirip. - Custom rule untuk aturan bisnis yang dipakai ulang, lengkap dengan unit test berbasis dataset.
- Aturan password terpusat lewat
Password::defaults(). - Nama atribut dan pesan dalam bahasa pengguna, dikelola di file bahasa.
Related Articles
- Cara Mengamankan Route, Controller, dan API Laravel Menggunakan Middleware dan Policy
- Panduan Mengelola File Upload Laravel agar Aman dari File Berbahaya
- Mencegah SQL Injection, Cross-Site Scripting, dan CSRF pada Aplikasi Laravel
- Cara Membangun CRUD Laravel yang Terstruktur Menggunakan Form Request, Service, dan Resource
Last Tested
| Komponen | Versi |
|---|---|
| Laravel | 13.x |
| PHP | 8.4 |
| MySQL | 8.4 LTS |
| Pest | 4.x |
| Tanggal | 19 Oktober 2026 |