Mode maintenance di Laravel sering digunakan saat kita perlu memperbarui aplikasi tanpa mengganggu pengguna lain. Dengan perintah artisan down
, aplikasi akan masuk ke mode maintenance, namun ini juga akan memblokir akses untuk kita sendiri. Laravel menyediakan fitur secret route yang memungkinkan kita mengakses aplikasi meskipun dalam mode maintenance. Fitur ini diperkenalkan di Laravel 8, tetapi untuk Laravel 6 dan 7, Kamu dapat menggunakan package tambahan.
Keuntungan Secret Route di Maintenance Mode
Memungkinkan aplikasi hanya dapat diakses oleh Kamu atau tim saat dalam mode maintenance.
Lebih mudah dibandingkan IP whitelisting, yang sering kali memerlukan konfigurasi rumit dan tidak mendukung IP dinamis.
Laravel 8 ke Atas: Fitur Bawaan Secret Route
Untuk Laravel 8 dan versi yang lebih baru, bypass maintenance mode dengan secret route sudah didukung secara bawaan. Kamu tidak perlu menginstal package tambahan. Berikut langkah penggunaannya:
Langkah Penggunaan:
Aktifkan mode maintenance dengan secret route menggunakan perintah berikut:
php artisan down --secret="mysecretkey"
Gunakan URL rahasia untuk mengakses aplikasi:
http://example.com/mysecretkey
- Ganti
mysecretkey
dengan kunci rahasia yang Kamu tetapkan. Pilih kunci yang kompleks untuk keamanan.
- Ganti
Saat aplikasi sudah siap, keluarkan dari mode maintenance dengan perintah:
php artisan up
Laravel 6 dan 7: Menggunakan Package Tambahan
Untuk Laravel versi 6 atau 7, Kamu bisa menggunakan package haruncpi/laravel-maintenance untuk fitur bypass secret route.
Langkah Instalasi:
Instal package dengan Composer:
composer require haruncpi/laravel-maintenance
Ubah middleware default di file
app/Http/Kernel.php
:Dari:
// \App\Http\Middleware\CheckForMaintenanceMode::class,
Menjadi:
\Haruncpi\LaravelMaintenance\Middleware\MaintenanceMode::class,
Aktifkan mode maintenance dengan secret route menggunakan perintah:
php artisan down --secret="mysecretkey"
Akses aplikasi dengan URL rahasia:
http://example.com/mysecretkey
Gunakan perintah berikut untuk mengembalikan aplikasi ke mode aktif:
php artisan up
Kesimpulan
Secret route di Laravel sangat membantu saat melakukan pembaruan aplikasi. Kamu dapat tetap mengakses aplikasi dengan aman tanpa mengganggu pengguna lainnya. Fitur ini mendukung Laravel 8 ke atas secara bawaan, sementara untuk Laravel 6 dan 7 dapat menggunakan package tambahan.
Bagikan panduan ini jika Kamu merasa artikel ini bermanfaat!