Gratis update & dukungan instalasi

Tutorial Website 14 Nov 2026

Cara Membuat Middleware Kustom di Laravel: Role, Langganan & Header Keamanan (Panduan 2026)

R Oleh renz mobellgnd
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:

Request → Middleware 1 → Middleware 2 → Controller → Middleware 2 → Middleware 1 → Response

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/:

php artisan make:middleware EnsureRole

Struktur dasarnya selalu sama: metode handle() menerima $request dan $next, lalu mengembalikan response:

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;
use Symfony\Component\HttpFoundation\Response;

class EnsureRole
{
public function handle(Request $request, Closure $next): Response
{
// Logika pemeriksaan ditulis di sini.

return $next($request);
}
}

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.phpAturan 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.phpMiddleware 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:

use App\Http\Middleware\EnsureRole;
use App\Http\Middleware\EnsureSubscriptionActive;
use App\Http\Middleware\SecurityHeaders;
use Illuminate\Foundation\Configuration\Middleware;

->withMiddleware(function (Middleware $middleware): void {
$middleware->alias([
'role' => EnsureRole::class,
'subscribed' => EnsureSubscriptionActive::class,
]);

$middleware->append(SecurityHeaders::class);
})

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:

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;
use Symfony\Component\HttpFoundation\Response;

class EnsureRole
{
public function handle(Request $request, Closure $next, string ...$roles): Response
{
$user = $request->user();

if (! $user || ! in_array($user->role, $roles, true)) {
abort(403, 'Anda tidak memiliki akses ke halaman ini.');
}

return $next($request);
}
}

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:

Route::middleware(['auth', 'role:admin,manager'])->group(function () {
Route::get('/laporan', [ReportController::class, 'index']);
});

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:

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;
use Symfony\Component\HttpFoundation\Response;

class EnsureSubscriptionActive
{
public function handle(Request $request, Closure $next): Response
{
$user = $request->user();

if (! $user || ! $user->hasActiveSubscription()) {
if ($request->expectsJson()) {
return response()->json([
'message' => 'Langganan Anda sudah berakhir. Perpanjang untuk melanjutkan.',
], 402);
}

return redirect()->route('subscription.renew')
->with('error', 'Langganan Anda sudah berakhir. Perpanjang untuk melanjutkan.');
}

return $next($request);
}
}

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:

Route::middleware(['auth', 'subscribed'])->group(function () {
Route::get('/fitur-premium', [PremiumController::class, 'index']);
});

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:

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Http\Request;
use Symfony\Component\HttpFoundation\Response;

class SecurityHeaders
{
public function handle(Request $request, Closure $next): Response
{
$response = $next($request);

$response->headers->set('X-Content-Type-Options', 'nosniff');
$response->headers->set('Referrer-Policy', 'strict-origin-when-cross-origin');
$response->headers->set('X-Frame-Options', 'DENY');

return $response;
}
}

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:

<?php

use App\Models\User;

test('admin bisa membuka laporan, member biasa ditolak', function () {
$this->actingAs(User::factory()->create(['role' => 'admin']))
->get('/laporan')
->assertOk();

$this->actingAs(User::factory()->create(['role' => 'member']))
->get('/laporan')
->assertForbidden();
});

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.