Mengatasi Error 500 Internal Server Error Pada Kitabantu Laravel

Kitabantu adalah platform galang dana online yang dibangun menggunakan framework Laravel yang merupakan kerangka kerja bahasa pemrograman PHP yang powerfull dan paling populer saat ini. Kitabantu bisa diinstal di server lokal untuk development dan bisa diinstal di hosting baik share hosting , cloud hosting maupun VPS. 

Saat anda pertama kali menginstal Kitabantu, ada beberapa konfigurasi dasar yang harus anda atur agar website berjalan dan berfungsi sebagaimana semestinya. Konfigurasi yang salah dapat menyebabkan website mengalami pesan kesalahan seperti Error 500, Internal Server Error, Error Occured dan beberapa menu yang tidak bisa berfungsi.

Kami akan menjelaskan kesalahan yang sering terjadi pada website Kitabantu dan bagaimana cara mengatasinya.

1. Server tidak sesuai dengan system requirement.

Penyebab pertama error saat menginstal Kitabantu adalah server yang anda gunakan tidak sesuai dengan system requirement yang dibutuhkan. Kitabantu membutuhkan persyaratan server sebagai berikut :

• PHP >= 7.2.0
• MySQL >= 5.6
• BCMath PHP Extension
• OpenSSL PHP Extension
• PDO PHP Extension
• Mbstring PHP Extension
• Tokenizer PHP Extension
• XML PHP Extension
• Ctype PHP Extension
• JSON PHP Extension
• Fileinfo PHP Extension
• cURL
• GD Library

Pastikan anda telah mengaktifkan semua ekstensi yang dibutuhkan diatas. Jika anda menggunakan layanan share hosting, silakan diskusikan dengan pusat bantuan hosting untuk permintaan aktivasi ekstensi pada PHP. Untuk anda yang menggunakan lokal server atau VPS silakan baca artikel : 10 Ekstensi PHP Yang Sering Digunakan, Fungsi dan Cara Mengaktifkan.

2. Pengaturan Database Salah

Kitabantu merupakan aplikasi berbasis laravel, oleh karena itu pengaturan database berada di file .env . Pastikan pengaturan database sudah sesuai dari mulai DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME dan DB_PASSWORD . Sebaiknya lakukan pengujian instalasi di localhost terlebih dulu sebelum di deploy ke hosting. 

Baca Juga : Cara Instal Projek Laravel di Localhost.

3. Terjadi Error Saat Proses Donasi

Kesalahan yang sering terjadi pada pengguna Kitabantu berikutnya adalah error saat proses donasi. Ketika donatur telah selesai mengisi data donasi dan akan meng-klik tombol Donasi malah muncul pesan error berupa error 500, internal server error atau error occured. Bahkan bisa saja tidak muncul pesan error namun stuk di loading yang menyebabkan proses donasi tidak dapat dilakukan.

Jika anda mengalami masalah diatas, penyebabnya adalah karena pengaturan SMTP email yang tidak valid. Penyebab kedua yaitu saat melakukan proses donasi, donatur memasukan email yang tidak aktif atau tidak valid.

Perlu diketahu bahwa website Kitabantu menggunakan SMTP mail sebagai pemroses pengiriman email. Proses pengiriman email dilakukan saat donatur selesai melakukan donasi, maka secara otomatis sistem akan melakukan kirim email notifikasi ke email donatur. Selain itu pengiriman email sistem terjadi saat pengguna melakukan pendaftaran baru (verifikasi email) dan saat pengguna lupa password (reset password).

Agar sistem dapat melaksanakan pengiriman email , anda perlu melakukan setting SMTP pada file .env secara benar. Langkah ini sudah dijelaskan pada konfigurasi dasar Kitabantu .

Informasi Penting :
Sebagian Hosting tidak mengizinkan penggunakan SMTP pihak ketiga seperti email Google. Solusinya adalah gunakan email yang dibuat dari mail server bawaan hosting. Silahkan konsultasi ke penyedia hosting untuk setelan SMTP Mail.

Jika anda tidak yakin dengan setelan SMTP mail dan ingin mematikan fitur notifikasi email ini, silahkan baca artikel : Menonaktifkan Fitur Notifikasi Email Donasi Kitabantu.

4. Terjadi Error Saat Donasi (Kesalahan API Payment Gateway)

Selain karena pengaturan smtp mail yang salah, error saat donasi juga disebabkan oleh penggunaan API payment gateway yang salah. Kitabantu menggunakan 3 payment gateway yaitu paypal, stripe dan duitku . Payment gateway yang membutuhkan akses API adalah stripe dan duitku. Pastikan anda mengatur API payment gateway dengan benar pada panel admin --> pengaturan pembayaran .

Untuk mendapatkan akses API anda harus mendaftar ke penyedia payment gateway dengan cara mengunjungi website resmi. Anda bisa menonaktifkan metode pembayaran jika anda belum punya kunci API yang valid agar tidak terjadi error saat donasi.

5. Tidak Bisa Masuk atau Daftar.

Penyebab tidak bisa masuk atau daftar di Kitabantu karena pengaturan recaptcha yang salah. Fungsi captcha adalah melindungi website dari serangan SPAM atau trafik palsu yang menyebabkan penurunan kinerja website. Untuk pengaturannya masih pada file .env . Ada dua parameter yang harus diisi yaitu INVISIBLE_RECAPTCHA_SITEKEY dan INVISIBLE_RECAPTCHA_SECRETKEY .

Untuk mendapatkan kode Site Key dan Secret Key silahkan daftarkan domain anda di :

https://www.google.com/recaptcha/admin

kemudian pilih reCaptcha v2 jenis invisible. Domain diisi dengan alamat website teman-teman.

Anda juga bisa menonaktifkan captcha di panel admin Pengaturan Umum --> Umum .

Demikian kesalahan yang mungkin terjadi saat anda menginstal aplikasi Kitabantu. Jika masih menemukan error yang lain, jangan sungkan-sungkan untuk berkonsultasi kepada admin.