Cara Membuat Middleware Kustom di Laravel: Role, Langganan & Header Keamanan (Panduan 2026)
Cara Membuat Middleware Kustom di Laravel: Role, Langganan & Header Keamanan (Panduan 2026)
Middleware Laravel adalah lapisan filter yang memeriksa request sebelum mencapai controller dan dapat mengubah response sesudahnya. Cara membuatnya adalah menjalankan php artisan make:middleware NamaMiddleware, menulis logika di metode handle(), mendaftarkannya sebagai alias di bootstrap/app.php, lalu menempelkannya ke route atau grup route yang membutuhkan.
Pola ini penting bagi penjual source code karena satu middleware yang ditulis rapi bisa dipakai ulang di banyak proyek: membatasi halaman admin berdasarkan role, menahan fitur berbayar bila langganan kedaluwarsa, dan menambahkan header keamanan tanpa mengotori setiap controller dengan if yang sama.
Apa itu middleware Laravel?
Bayangkan setiap request melewati gerbang berlapis sebelum sampai ke tujuan:
Middleware yang bekerja sebelum controller disebut before middleware: ia boleh meneruskan request dengan return $next($request), atau menghentikannya lebih awal dengan redirect, respons 403, atau respons JSON 402/403. Middleware yang bekerja sesudah controller memanggil $next($request) dulu, lalu memodifikasi $response sebelum dikembalikan ke browser.
Laravel sendiri sudah membawa middleware bawaan seperti auth, throttle, dan verifikasi CSRF. Middleware kustom dibutuhkan saat aturannya spesifik milik aplikasi Anda, misalnya "hanya admin dan manajer yang boleh membuka laporan" atau "fitur ini hanya untuk pelanggan aktif". Aturan seperti itu tidak pantas ditulis berulang di setiap controller, karena mudah terlupa di satu route dan sulit diubah ketika kebijakan berubah.
Bagaimana cara membuat middleware pertama di Laravel?
Buat middleware dengan Artisan. Perintah ini menghasilkan file di app/Http/Middleware/:
Struktur dasarnya selalu sama: metode handle() menerima $request dan $next, lalu mengembalikan response:
Satu kesalahan umum pada proyek lama adalah mencari app/Http/Kernel.php. Sejak Laravel 11, file itu tidak lagi dipakai untuk mendaftarkan middleware; pendaftarannya pindah ke bootstrap/app.php. Tutorial yang masih mengarahkan Anda mengedit Kernel untuk Laravel 11 atau 12 sudah kedaluwarsa, apa pun tanggal publikasinya.
Bagaimana cara mendaftarkan middleware di Laravel 11 dan 12?
Di bootstrap/app.php, ada empat cara menempelkan middleware, dan memilih yang salah adalah sumber bug paling sering:
| Cara Tempat daftar Cocok untuk | ||
| Global | $middleware->append() di bootstrap/app.php | Aturan yang berlaku untuk semua request, misalnya header keamanan |
Grup web / api | $middleware->web(append: [...]) atau $middleware->api(append: [...]) | Aturan yang hanya berlaku untuk route web atau API |
| Alias | $middleware->alias([...]) di bootstrap/app.php | Middleware yang dipakai di route tertentu dengan nama pendek |
| Langsung di route | ->middleware(NamaMiddleware::class) | Satu route saja, tanpa perlu nama alias |
Untuk tutorial ini, pakai alias karena paling mudah dibaca dan dipakai ulang:
Perhatikan urutan pada route: auth harus berjalan sebelum middleware role atau langganan, karena keduanya membutuhkan pengguna yang sudah login. Menulis ['role:admin'] tanpa auth akan membuat $request->user() bernilai null dan menghasilkan error, bukan halaman login yang rapi.
Bagaimana cara membuat middleware role dengan parameter?
Middleware role yang baik menerima parameter, bukan mengunci satu role di dalam kode. Dengan begitu, satu class bisa melayani role:admin, role:admin,manager, atau role:kasir:
Sesuaikan $user->role dengan skema proyek Anda: bisa berupa kolom role di tabel users, atau relasi roles yang perlu dicek dengan hasRole(). Prinsipnya sama, hanya sumber datanya yang berbeda. Pemakaian di route menjadi sangat deklaratif:
Jika proyek Anda sudah memakai sistem permission yang lebih halus — misalnya satu pengguna bisa punya banyak permission di banyak modul — middleware role sebaiknya hanya menjadi gerbang kasar, sementara izin detail ditangani Gate atau Policy. Membebani middleware dengan puluhan aturan permission akan membuatnya sulit dibaca dan sulit diuji. Panduan role dan permission di KiosKoding membahas pemisahan ini lebih dalam.
Bagaimana cara membuat middleware cek langganan aktif?
Kasus kedua ini sangat relevan untuk source code yang dijual dengan skema berlangganan. Middleware harus bersikap berbeda untuk request web dan API: pengguna web diarahkan ke halaman perpanjangan, sedangkan klien API menerima JSON yang bisa diproses program:
Metode hasActiveSubscription() di contoh ini adalah penanda: implementasikan sesuai skema Anda, misalnya membandingkan subscription_ends_at dengan waktu sekarang dan memastikan statusnya aktif. Jangan pernah hanya mengandalkan middleware untuk urusan pembayaran — middleware hanya menegakkan status yang sudah dicatat dengan benar di database, sementara pencatatan status itu sendiri harus berasal dari webhook payment gateway yang terverifikasi.
Pakai middleware ini pada grup route fitur berbayar, bukan pada seluruh aplikasi, agar halaman perpanjangan dan halaman bantuan tetap bisa dibuka oleh pelanggan yang langganannya sudah habis:
Untuk API mobile, pola yang sama berlaku: gabungkan middleware ini dengan autentikasi token, seperti yang dibahas pada panduan autentikasi API Laravel dengan Sanctum.
Bagaimana cara menambahkan header keamanan dengan middleware?
Header keamanan adalah contoh after middleware yang ideal: ia tidak memblokir siapa pun, hanya memperkeras setiap response yang keluar. Karena didaftarkan global, satu tempat ini melindungi semua halaman tanpa mengubah controller mana pun:
Perlu dicatat: X-Frame-Options: DENY tidak cocok jika aplikasi Anda memang perlu di-embed di iframe, misalnya widget yang dipasang di situs pelanggan. Untuk kasus itu, ganti dengan SAMEORIGIN atau kebijakan frame-ancestors pada Content Security Policy. Header keamanan melengkapi, bukan menggantikan, langkah lain seperti pembatasan percobaan login yang dibahas pada panduan throttle dan anti brute force.
Bagaimana cara menguji middleware sebelum dipakai produksi?
Middleware yang tidak diuji adalah janji keamanan yang belum terbukti. Uji minimalnya ada tiga skenario: pengguna yang berhak lolos, pengguna yang tidak berhak ditolak, dan pengguna yang belum login diarahkan ke login. Contoh tes fitur berikut memakai route yang dilindungi role:admin:
Selain tes otomatis, lakukan dua pemeriksaan manual: buka route yang dilindungi tanpa login untuk memastikan redirect-nya benar, dan buka route publik untuk memastikan middleware global tidak ikut memblokirnya. Jika Anda memakai middleware untuk mencatat aktivitas, pastikan tabel log tidak membengkak — panduan activity log Laravel membahas strategi penyimpanan dan retensinya.
Kapan middleware TIDAK cocok dipakai?
Middleware bukan tempat untuk logika bisnis yang berat. Jangan menaruh query kompleks, pemanggilan API eksternal yang lambat, atau perhitungan laporan di dalam middleware, karena kode itu akan berjalan pada setiap request yang melewatinya dan memperlambat seluruh aplikasi. Logika semacam itu milik service class atau controller.
Hindari juga tiga jebakan berikut: menduplikasi auth bawaan dengan middleware login buatan sendiri, menulis aturan yang berbeda antara route web dan API tanpa alasan yang jelas, serta mengembalikan halaman error umum yang tidak menjelaskan apa yang harus dilakukan pengguna selanjutnya. Pesan penolakan yang baik selalu memberi jalan keluar: login dulu, hubungi admin, atau perpanjang langganan.
Kesimpulan
Middleware kustom Laravel yang bagus punya tiga ciri: satu tanggung jawab per class, parameter untuk variasi aturan, dan respons penolakan yang sesuai jenis request. Mulailah dari middleware role berparameter, tambahkan pengecekan langganan untuk fitur berbayar, dan tutup dengan header keamanan global. Dengan pola ini, aturan akses proyek Anda tinggal dibaca dari daftar middleware di route — bukan ditebak dari if yang tersebar di puluhan controller.
FAQ
Apa bedanya middleware dengan Gate dan Policy di Laravel?
Middleware adalah gerbang di level route: ia memutuskan apakah request boleh masuk ke controller. Gate dan Policy bekerja di level aksi dan data, misalnya apakah pengguna boleh mengedit satu produk tertentu milik tokonya sendiri. Gunakan middleware untuk gerbang kasar, Gate/Policy untuk izin detail.
Apakah middleware bisa dipakai di route API saja?
Bisa. Daftarkan lewat $middleware->api(append: [...]) untuk semua route API, atau tempelkan alias ke grup route di routes/api.php. Pastikan respons penolakannya JSON, bukan redirect ke halaman login, agar klien mobile atau frontend tidak salah memprosesnya.
Berapa banyak middleware yang boleh menempel di satu route?
Tidak ada batas teknis yang ketat, tetapi secara praktis jagalah tetap sedikit dan terurut logis: autentikasi dulu, lalu pembatasan rate, lalu role atau langganan. Tumpukan yang terlalu panjang biasanya tanda ada aturan yang seharusnya digabung atau dipindah ke service class.
Apakah middleware berjalan untuk request yang gagal validasi?
Validasi form di controller atau Form Request berjalan setelah middleware. Jadi middleware tidak bisa menggantikan validasi input; ia hanya memastikan siapa yang boleh sampai ke tahap validasi itu. Keduanya saling melengkapi, bukan saling menggantikan.
Apa itu terminable middleware?
Terminable middleware memiliki metode terminate() yang berjalan setelah response dikirim ke pengguna. Ia cocok untuk pekerjaan ringan pasca-response seperti mencatat metrik, tetapi tidak boleh dipakai untuk memblokir request — karena pada titik itu, response sudah terlanjur terkirim.
Apakah mengubah middleware memerlukan restart server?
Tidak, selama Anda memakai php artisan serve atau PHP-FPM biasa, perubahan file middleware langsung berlaku pada request berikutnya. Yang perlu diingat adalah membersihkan cache konfigurasi dan route (php artisan config:clear dan php artisan route:clear) bila Anda mengubah pendaftaran middleware tetapi hasilnya tidak berubah.
Artikel Terkait
PHP 8.6.0 RC5 Rilis 5 November 2026: Kandidat Terakhir Sebelum Final 19 November
14 Nov 2026
Cara Membuat Sistem Membership & Langganan Berbayar di Laravel: Paket, Pembayaran & Middleware (Panduan 2026)
14 Nov 2026
Laravel 13.40.0 Rilis 3 November 2026: Alert Job Lambat, Commit ID Replika & Perbaikan Keamanan Concurrency
14 Nov 2026
WordPress 7.2 Beta 4 Rilis 3 November 2026: Kenapa Bukan Beta 3 & Apa yang Wajib Diuji
14 Nov 2026