Panduan Praktis Membuat Custom Middleware Validasi di Laravel

Pendahuluan

Pernah nggak kepikiran, kenapa Laravel terasa sangat nyaman dipakai padahal kita sering terjebak validasi data yang berulang-ulang di tiap controller? Biasanya saat ngerjain API, saya sering banget males nulis logika validasi yang sama di lima method berbeda, sampai akhirnya saya sadar kalau Middleware adalah kunci biar kode kita tetap bersih dan nggak bikin pusing di masa depan.

Tips & Best Practices

• Di banyak project, saya selalu buat satu middleware khusus untuk satu tanggung jawab; jangan mencampur urusan auth, logging, dan validasi dalam satu file biar proses debugging nggak kayak nyari jarum dalam jerami.
• Saat nentuin nama middleware, saya saranin pakai nama yang deskriptif berdasarkan aksi, misalnya EnsureDataIsValid, supaya rekan tim lain nggak perlu buka isi kodenya buat tahu fungsinya.
• Saya terbiasa memisahkan logic validasi ke dalam FormRequest jika validasinya kompleks, dan pakai middleware hanya sebagai gatekeeper untuk request yang datang dari luar.

Contoh Kode

Bayangin kita mau validasi input API key biar nggak bocor ke sistem. Saya biasanya buat middleware lewat php artisan make:middleware CheckApiKey:

public function handle(Request $request, Closure $next) { if ($request->header('X-API-KEY') !== config('app.api_key')) { return response()->json(['message' => 'Unauthorized'], 403); } return $next($request); }

Variasi Implementasi

Kita punya dua pilihan: pakai middleware untuk validasi ketat di level request, atau pakai FormRequest yang lebih natural buat validasi data form. Kalau middleware, saya pakai buat ngecek 'siapa' yang akses, sedangkan FormRequest lebih ke 'apa' isi datanya. Pakai middleware terlalu dalam buat validasi field itu kadang malah bikin kode jadi susah dites.

Kesalahan Umum

• Lupa daftarin middleware di file app/Http/Kernel.php atau bootstrap/app.php yang sering bikin kita bingung kenapa kodenya nggak jalan-jalan.
• Terlalu banyak logic bisnis di dalam middleware yang malah bikin aplikasi terasa berat setiap kali hit endpoint.
• Mengembalikan respons redirect() di middleware yang harusnya dipakai buat API, alhasil user malah dapat error HTML aneh.
• Tidak menangani $request->expectsJson(), sehingga user yang akses via browser malah dikasih tampilan error polos.
• Membuat middleware yang menahan request terlalu lama karena query database yang kompleks di dalamnya.

Ringkasan

Pada akhirnya, custom middleware itu bukan cuma soal rapi-rapi kode, tapi soal gimana kita ngebangun 'penjaga' yang efisien buat aplikasi kita. Kalau sudah paham polanya, nambahin fitur validasi atau security di tengah jalan jadi jauh lebih santai tanpa harus ngerombak banyak file controller.