Cara Konfigurasi Middleware di Laravel 11+ yang wajib developer ketahui

Saya masih ingat jelas bagaimana ekspresi bingung di wajah saya saat pertama kali membuka proyek Laravel 11. "Lho, folder app/Http/Middleware-nya kok nggak ada?" Setelah bertahun-tahun menggunakan Laravel dan terbiasa dengan strukturnya yang sudah seperti rumah sendiri, perubahan di versi 11 ini awalnya bikin pusing!

Yang paling mengejutkan adalah hilangnya file app/Http/Kernel.php yang selalu menjadi tempat pertama saya mengonfigurasi middleware.

Perubahan di Laravel 11 dan Setelahnya

Penting untuk dipahami bahwa perubahan ini dimulai di Laravel 11 dan tetap berlanjut di versi-versi setelahnya, termasuk Laravel 12. Dokumentasi resmi Laravel menyebutkan dengan jelas. Baca di sini.

"Dimulai dari Laravel 11, konfigurasi middleware tidak lagi menggunakan HTTP Kernel, tetapi beralih ke file bootstrap aplikasi."

Perubahan ini merupakan bagian dari evolusi framework Laravel yang terus berjalan. Di Laravel 11+, struktur aplikasi dibuat lebih ramping dengan lebih sedikit file default, termasuk service providers, middleware, dan file konfigurasi.

File Bootstrap Sebagai Pusat Middleware Laravel

File bootstrap/app.php sekarang menjadi pusat kendali untuk konfigurasi middleware di Laravel 11 dan versi setelahnya Laravel 12. Menggunakan metode withMiddleware(), kita dapat mengkonfigurasi semua aspek middleware yang sebelumnya dilakukan melalui HTTP Kernel.

// bootstrap/app.php
 
use App\Http\Middleware\LogRequest;
 
->withMiddleware(function (Middleware $middleware) {
    // Menambahkan di akhir stack middleware
    $middleware->append(LogRequest::class);
})

Cara Mendefinisikan Grup Middleware di Laravel 11+

Di Laravel versi sebelumnya, kita mendefinisikan grup middleware menggunakan properti $middlewareGroups. Tapi di Laravel 11+ caranya berubah:

$middleware->prependToGroup('group-1', First::class);
 
$middleware->appendToGroup('group-1', [
    First::class,
    Second::class,
]);

Untuk grup bawaan seperti 'web' atau 'api', Laravel 11+ menyediakan metode yang lebih spesifik:

$middleware->web(append: [
    ExampleWebMiddleware::class,
]);
 
$middleware->api(prepend: [
    ExampleApiMiddleware::class,
]);

Mengonfigurasi Prioritas dan Alias Middleware Laravel

Prioritas middleware di Laravel 11+ diatur menggunakan metode priority():

->withMiddleware(function (Middleware $middleware) {
    $middleware->priority([
        // Daftar middleware berdasarkan prioritas
    ]);

Untuk alias middleware, gunakan metode alias():

->withMiddleware(function (Middleware $middleware) {
    $middleware->alias([
        'log' => LogRequest::class
    ]);
});

Kesalahan yang Harus Dihindari Saat Upgrade Laravel

Salah satu kesalahan terbesar yang saya lakukan adalah mencoba memindahkan semua middleware proyek lama ke struktur baru secara paksa. Jangan dicontoh! Laravel 11 dan versi setelahnya dirancang untuk tetap mendukung struktur aplikasi versi sebelumnya, jadi lebih baik biarkan aplikasi yang di-upgrade tetap dengan struktur lamanya.

Dokumentasi menyebutkan dengan jelas: "Kami tidak merekomendasikan aplikasi Laravel 10 yang di-upgrade ke Laravel 11 untuk mencoba memigrasikan struktur aplikasi mereka, karena Laravel 11 telah dengan hati-hati diatur untuk juga mendukung struktur aplikasi Laravel 10."

Tips Beradaptasi dengan Laravel 11+ 

Ada tips penting untuk kalian yang baru mulai dengan Laravel 11 atau versi setelahnya - jangan langsung terjun ke kode. Luangkan waktu setidaknya 30 menit untuk membaca dokumentasi resminya terlebih dahulu. Percayalah, ini akan menghemat berjam-jam frustrasi nantinya.

Saya sempat membuat cheat sheet kecil berisi pemetaan antara cara lama dan cara baru mengatur middleware. Ternyata ini sangat membantu saat bekerja dengan proyek-proyek yang menggunakan versi Laravel berbeda.

Kesimpulan: Framework Laravel Terus Berevolusi

Sekarang, setelah beberapa bulan menggunakan Laravel 11 dan melihat arah perkembangan framework ini, saya tidak ingin kembali ke versi sebelumnya. Perubahan konfigurasi middleware ini menandai arah baru dalam evolusi Laravel yang akan terus berlanjut di versi-versi mendatang.

Jadi, jika teman-teman masih ragu untuk upgrade ke Laravel 11 atau version setelahnya karena takut dengan perubahan middleware-nya, jangan khawatir. Memang ada learning curve di awal, tapi percayalah, teman-teman akan terbiasa lebih cepat dari yang teman-teman kira. Dan siapa tahu, mungkin teman-teman akan menyukai perubahan ini sama seperti saya!

Ingat, dalam pengembangan web dengan Laravel, adaptasi adalah kunci. Laravel 11+ membawa kita selangkah lebih maju ke arah framework yang lebih ramping, efisien, dan mudah dikelola untuk masa depan.