Pesan Apache 500 Internal Server Error saat mengakses file berformat .shtml (Server Side Includes) biasanya disebabkan oleh kesalahan konfigurasi pada direktif SSI, kesalahan sintaks dalam file HTML yang memuat perintah SSI, atau pembatasan izin (permissions) file yang terlalu ketat pada server web Apache. Masalah ini menghentikan server dalam memproses instruksi #include atau perintah modular lainnya sebelum dikirimkan ke peramban pengguna.
Untuk menyelesaikan masalah ini secara permanen, Anda perlu memeriksa file log kesalahan (error log) Apache untuk mengetahui baris spesifik yang memicu kegagalan, memvalidasi konfigurasi modul mod_include, serta memastikan aturan izin file dan direktori sudah diatur dengan benar.
Matriks Pemeriksaan Penyebab Error 500 pada SHTML
| Penyebab Utama | Gejala / Indikasi | Solusi Teknis |
|---|---|---|
| Kesalahan Sintaks SSI | Halaman utama gagal dimuat total, error tercatat di log Apache. | Periksa tag <!--#include ... -->, pastikan path file benar. |
| Modul mod_include Non-aktif | Server menolak memproses seluruh file .shtml. |
Aktifkan modul Apache menggunakan perintah terminal a2enmod include. |
| Konfigurasi .htaccess Salah | Error muncul setelah mengubah direktif handler atau Options. | Tambahkan izin eksekusi SSI yang valid pada file konfigurasi. |
| Izin File (Permissions) | File dapat diakses sebagai teks biasa, tetapi error saat diproses SSI. | Ubah izin file menjadi 644 dan direktori menjadi 755. |
Langkah-Langkah Perbaikan Teknis
1. Periksa Log Kesalahan Apache (Error Log)
Langkah paling akurat untuk menemukan akar masalah adalah membaca log server Apache. Bergantung pada sistem operasi peladen Anda (Ubuntu/Debian atau CentOS/RHEL), file log terletak di direktori berikut:
# Ubuntu / Debian
tail -n 50 /var/log/apache2/error.log
# CentOS / RHEL / AlmaLinux
tail -n 50 /var/log/httpd/error_logCari baris yang mengandung keterangan seperti AH01215: end of script output before headers atau pesan spesifik mengenai kegagalan pembacaan file SSI.
2. Konfigurasi File .htaccess untuk SSI
Jika server Anda menggunakan file .htaccess untuk mengatur handler SSI, pastikan direktif yang digunakan sudah benar dan diizinkan oleh konfigurasi utama server (httpd.conf atau apache2.conf melalui opsi AllowOverride All).
# Tambahkan baris ini ke dalam file .htaccess Anda
AddType text/html .shtml
AddHandler server-parsed .shtml
Options +Includes3. Validasi Perintah Server Side Includes (SSI)
Sintaks SSI yang salah, seperti memanggil file eksternal dengan path absolut yang salah atau menggunakan direktif yang tidak didukung, akan memicu kegagalan fatal pada Apache. Pastikan format pemanggilan file benar:
<!--#include virtual="/header.shtml" -->
<!-- atau menggunakan path relatif -->
<!--#include file="footer.shtml" -->4. Perbaikan Izin File dan Kepemilikan (Permissions)
Izin file yang terlalu longgar (misalnya 777) sering kali ditolak oleh keamanan Apache dan memicu error 500. Jalankan perintah berikut melalui SSH untuk memperbaiki izin file .shtml Anda:
find /var/www/html/ -type f -name "*.shtml" -exec chmod 644 {} \;
find /var/www/html/ -type d -exec chmod 755 {} \;
chown -R www-data:www-data /var/www/html/Catatan: Sesuaikan www-data dengan pengguna web server Anda (misalnya apache atau nobody pada lingkungan berbasis RedHat).