Error SHTML umumnya terjadi ketika server web, terutama Apache, gagal memproses SSI (Server Side Includes) atau mengalami masalah konfigurasi file .htaccess yang menyebabkan halaman web gagal dimuat dengan sempurna atau memunculkan status Internal Server Error 500. Masalah ini sering kali dipicu oleh sintaks SSI yang keliru, izin file yang salah, atau modul mod_include pada server yang belum diaktifkan oleh penyedia hosting.
Untuk mengatasi error SHTML secara tuntas, Anda memerlukan akses ke direktori root website melalui cPanel, File Manager, atau klien FTP seperti FileZilla. Pendekatan perbaikan harus dimulai dari pemeriksaan file log error server untuk mengetahui akar penyebab spesifik, diikuti dengan pengecekan konfigurasi file .htaccess dan perbaikan izin file serta direktori yang bersangkutan.
Penyebab Utama dan Diagnostik Error SHTML
Langkah awal yang paling krusial sebelum melakukan perubahan pada file sistem adalah membaca file error_log yang biasanya terletak di direktori utama public_html atau folder yang sama dengan file SHTML yang bermasalah. Pesan error yang tercatat di dalam log ini akan memberikan petunjuk akurat, apakah masalahnya berasal dari perintah include yang mengarah ke file non-existent, kesalahan sintaks tag SSI, atau batasan memori server.
Selain itu, pastikan ekstensi file Anda sudah benar dan server dikonfigurasi untuk mengenali ekstensi .shtml sebagai handler parse server-side includes. Tanpa konfigurasi handler yang tepat di Apache, server akan memperlakukan file SHTML sebagai file HTML biasa atau menolak mengeksekusinya, yang berujung pada kegagalan rendering halaman secara keseluruhan.
| Jenis Error SHTML | Penyebab Utama di Server | Solusi Teknis Cepat |
|---|---|---|
| Internal Server Error 500 | Sintaks .htaccess salah atau directive SSI tidak valid | Periksa baris kode di .htaccess dan hapus baris yang error |
| [an error occurred while processing this directive] | File yang di-include tidak ditemukan atau salah path | Koreksi path relatif atau absolut pada tag #include |
| File SHTML diunduh, bukan dirender | Modul mod_include atau Handler Apache belum aktif | Tambahkan AddHandler server-parsed .shtml pada konfigurasi |
Perbaikan Konfigurasi File .htaccess
File .htaccess yang korup atau mengandung aturan yang bertentangan adalah penyebab paling sering dari error SHTML. Anda perlu memeriksa apakah ada baris perintah yang salah ketik atau tidak didukung oleh versi PHP dan Apache yang sedang digunakan pada server hosting Anda saat ini.
Untuk memastikan server Apache memproses file SHTML dengan benar, tambahkan baris kode handler khusus ke dalam file .htaccess Anda. Pastikan juga modul mod_include telah diizinkan untuk berjalan pada direktori tersebut melalui pengaturan Options Indexes Includes.
Contoh kode penambahan handler SSI yang benar pada file .htaccess:
AddType text/html .shtml
AddHandler server-parsed .shtml
Options +IncludesJika setelah menambahkan kode tersebut website Anda justru mengalami error 500, artinya server hosting Anda tidak mengizinkan penggunaan perintah Options +Includes di dalam file .htaccess. Segera hapus baris tersebut dan hubungi dukungan teknis hosting untuk mengaktifkan modul mod_include di tingkat server utama.
Memperbaiki Tag SSI yang Rusak
Kesalahan penulisan sintaks Server Side Includes di dalam file SHTML itu sendiri sering kali memicu pesan error teks merah di halaman web atau membuat server menghentikan proses rendering. Format penulisan SSI yang valid harus selalu diapit oleh komentar HTML khusus agar dikenali oleh server.
Perhatikan contoh penulisan tag include yang benar dan salah berikut ini:
Penggunaan parameter virtual jauh lebih disarankan daripada file karena parameter virtual menggunakan path relatif terhadap dokumen root web, sehingga lebih sedikit memicu kesalahan direktori. Pastikan juga file yang dipanggil melalui tag include benar-benar ada di dalam server dan memiliki izin baca yang valid.
Pengaturan Hak Akses File dan Direktori (Chmod)
Izin file yang terlalu longgar atau terlalu ketat dapat menyebabkan server menolak mengeksekusi file SHTML demi alasan keamanan. Standar keamanan untuk file berbasis web di lingkungan server Linux adalah 644 untuk semua file (termasuk .shtml dan .html) serta 755 untuk semua direktori atau folder.
Gunakan File Manager di cPanel atau klien FTP untuk memeriksa permission file SHTML Anda. Klik kanan pada file yang bermasalah, pilih Change Permissions, dan pastikan angka yang tertera adalah 644. Jika izin file diatur menjadi 777, beberapa server berbasis Apache dengan modul keamanan suEXEC justru akan memblokir eksekusi file tersebut dan memunculkan error.
Dengan melakukan pemeriksaan menyeluruh mulai dari log error, penyesuaian file .htaccess, validasi tag SSI, hingga pengaturan hak akses file yang tepat, masalah error SHTML pada website Anda dapat diselesaikan dengan cepat dan akurat tanpa harus merombak seluruh struktur situs.