Cara Bypass Maintenance Mode Laravel dengan Secret Route

Photo by Dan Loran on Unsplash

Cara Bypass Maintenance Mode Laravel dengan Secret Route

·

2 min read

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:

  1. Aktifkan mode maintenance dengan secret route menggunakan perintah berikut:

     php artisan down --secret="mysecretkey"
    
  2. Gunakan URL rahasia untuk mengakses aplikasi:

     http://example.com/mysecretkey
    
    • Ganti mysecretkey dengan kunci rahasia yang Kamu tetapkan. Pilih kunci yang kompleks untuk keamanan.
  3. 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:

  1. Instal package dengan Composer:

     composer require haruncpi/laravel-maintenance
    
  2. Ubah middleware default di file app/Http/Kernel.php:

    Dari:

     // \App\Http\Middleware\CheckForMaintenanceMode::class,
    

    Menjadi:

     \Haruncpi\LaravelMaintenance\Middleware\MaintenanceMode::class,
    
  3. Aktifkan mode maintenance dengan secret route menggunakan perintah:

     php artisan down --secret="mysecretkey"
    
  4. Akses aplikasi dengan URL rahasia:

     http://example.com/mysecretkey
    
  5. 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!