Membuka halaman web yang kamu kembangkan lalu mendapati layar putih bertulisan “500 Internal Server Error” memang membuat bingung. Tidak ada petunjuk apa yang salah. Error 500 di PHP termasuk yang paling menyebalkan karena pesan errornya sengaja disembunyikan dari pengunjung. Penyebabnya perlu dicari sendiri, dan artikel ini memandu kamu menanganinya langkah demi langkah.
Apa Itu Error 500 dan Mengapa Terjadi?
Kode status HTTP 500 berarti server mengalami kondisi tak terduga dan gagal menyelesaikan permintaan. Pada PHP, error ini muncul ketika skrip mengalami fatal error, parse error, atau ada masalah konfigurasi server. Server biasanya tidak menampilkan detail error ke pengguna karena alasan keamanan.
Beberapa penyebab umum error 500 di PHP antara lain:
- Kesalahan sintaks (parse error) yang tidak tertangani.
- Memanggil fungsi yang tidak ada atau salah parameter.
- Hak akses file atau folder yang salah (permission denied).
- Konfigurasi .htaccess yang rusak.
- Batas memori (memory limit) terlampaui.
- Koneksi database gagal tanpa penanganan exception.
Menemukan penyebabnya memerlukan pendekatan sistematis. Mulai dari langkah paling dasar.
Langkah Pertama: Aktifkan Tampilan Error untuk Debugging
Di lingkungan pengembangan, kamu bisa menampilkan pesan error langsung di browser dengan mengubah konfigurasi PHP. Tambahkan baris berikut di awal skrip atau di file konfigurasi php.ini:
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);Pesan error akan terlihat dan kamu bisa langsung mengetahui baris kode mana yang bermasalah. Jangan pernah mengaktifkan tampilan error di server produksi karena berpotensi membocorkan informasi sensitif.
Memeriksa Log Error Server
Jika kamu tidak bisa mengubah konfigurasi PHP, log error adalah tempat pertama yang perlu dicek. Lokasinya bervariasi tergantung server, misalnya /var/log/apache2/error.log untuk Apache di Linux, atau melalui cPanel di menu Error Log. Di log inilah pesan error sebenarnya dicatat. Cari baris yang menyebutkan file PHP dan nomor barisnya, lalu lacak penyebabnya dari sana.
Jika error terjadi karena query database, kamu mungkin perlu melakukan debug query secara mendalam. Ada panduan terpisah yang membahas cara debug query MySQL di PHP yang bisa kamu ikuti.
Penyebab Umum dan Solusinya
1. Parse Error karena Sintaks Salah
Parse error terjadi ketika ada kesalahan penulisan kode, seperti kurang titik koma, kurung kurawal tidak tertutup, atau tanda kutip yang tidak berpasangan. Error ini biasanya disertai pesan “syntax error, unexpected …” di log. Perbaiki sintaks dan coba lagi.
2. File atau Folder Tidak Memiliki Izin yang Tepat
Server web berjalan dengan user tertentu (misalnya www-data). Jika file PHP atau folder tidak dapat dibaca oleh user tersebut, muncul error 500. Pastikan permission file PHP minimal 644 dan folder 755. Gunakan perintah chmod jika perlu.
3. Kesalahan pada .htaccess
File .htaccess yang berisi aturan rewrite atau konfigurasi lain bisa menyebabkan error 500 jika ada baris yang tidak valid. Coba nonaktifkan sementara .htaccess dengan mengganti namanya, lalu akses kembali halaman. Jika error hilang, periksa isi .htaccess baris per baris.
4. Memori Terlalu Kecil
Skrip yang memproses data besar atau menggunakan library berat bisa kehabisan memori. Pesan error di log biasanya menyebutkan “Allowed memory size exhausted”. Solusinya, naikkan nilai memory_limit di php.ini atau via ini_set('memory_limit', '256M'); di skrip.
5. Koneksi Database Gagal
Jika skrip mencoba terhubung ke database tetapi gagal tanpa penanganan exception, error 500 bisa muncul. Pastikan kredensial database benar dan server database berjalan. Bungkus koneksi dengan blok try-catch untuk menangani error dengan lebih baik. Jika kamu bingung memilih metode koneksi, ada perbandingan PDO vs MySQLi yang bisa membantu.
Teknik Debugging Lanjutan
Ketika cara dasar belum berhasil, kamu bisa menggunakan teknik berikut:
- Matikan sementara plugin atau library yang mencurigakan untuk mengisolasi masalah.
- Gunakan error handler kustom untuk menangkap error dan mencatatnya ke file log sendiri.
- Periksa versi PHP yang digunakan; beberapa fungsi mungkin sudah dihapus di versi terbaru.
- Uji di lingkungan lokal dengan konfigurasi yang mirip server untuk mereproduksi error.
Jika kamu mencurigai ada masalah dalam penggabungan PHP dan JavaScript yang menyebabkan error, artikel tentang kesalahan umum saat menggabungkan PHP dan JavaScript bisa menjadi referensi tambahan.
Mencegah Error 500 di Masa Depan
Setelah berhasil mengatasi error, terapkan praktik pencegahan. Aktifkan error reporting saat pengembangan, tulis kode dengan penanganan exception yang rapi, dan lakukan pengujian sebelum deploy. Gunakan version control untuk melacak perubahan. Pastikan juga konfigurasi server sesuai dengan kebutuhan aplikasi.
Bagi kamu yang suka menonton olahraga seperti basket, sepak bola, atau UFC, ada cara menonton bareng secara gratis dengan host yang menghibur di tarkamlive.com.
Pertanyaan yang Sering Diajukan
Bagaimana cara cepat mengetahui penyebab error 500?
Cek log error server. Di sana tercatat pesan error sebenarnya beserta file dan baris yang bermasalah. Jika tidak ada akses log, aktifkan display_errors sementara di lingkungan pengembangan.
Apakah error 500 selalu disebabkan oleh kode PHP?
Tidak selalu. Konfigurasi server seperti .htaccess yang salah, permission file, atau batas memori juga bisa memicu error 500. Periksa juga faktor di luar kode.
Bagaimana cara menangani error 500 tanpa menampilkan pesan ke pengguna?
Gunakan custom error page dengan kode status 500, dan catat detail error ke log. Pengguna tidak melihat pesan teknis, tetapi kamu tetap bisa melakukan debugging.