Source code aplikasi, template web, dan ebook. Unduh dari akun setelah bayar. Lihat produk

Blog / Keamanan / Panduan Validasi Form Laravel...
Keamanan

Panduan Validasi Form Laravel Menggunakan Form Request dan Custom Validation Rules

AD

Admin HijrahKreativa

Penulis

19 Oct 2026
13 min read
26 views

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_id milik keluarga lain lewat field tersembunyi, dan aplikasi menerimanya.
  • Jumlah iuran negatif lolos dan saldo kas menjadi kacau.
  • Kolom role=admin ikut terkirim dan tersimpan karena controller memakai $request->all().
  • Nomor HP disimpan dalam lima format berbeda, sehingga pencarian dan notifikasi gagal.
  • Array items berisi 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 exists yang 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:100 membatasi jumlah baris.
  • distinct mencegah 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 pernah all().
  • 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_id warga), ambil dari sesi, bukan dari input.
  • Pertahankan constraint database (unik, foreign key, NOT NULL) sebagai pengaman terakhir.

Performa

  • bail sebelum aturan yang melakukan query.
  • Validasi massal satu query di after() untuk array besar.
  • stopOnFirstFailure untuk 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

Last Tested

Komponen Versi
Laravel 13.x
PHP 8.4
MySQL 8.4 LTS
Pest 4.x
Tanggal 19 Oktober 2026

Bagikan artikel:

Artikel lainnya