Konfigurasi .htaccess AddHandler Server-Parsed untuk SSI

Penggunaan direktif AddHandler server-parsed .shtml .html di dalam file .htaccess berfungsi untuk menginstruksikan server web Apache agar memproses file dengan ekstensi tertentu menggunakan modul mod_include. Proses ini dikenal sebagai Server Side Includes (SSI), yang memungkinkan penyisipan konten dokumen lain ke dalam satu halaman web sebelum disajikan ke peramban pengguna.

Kesalahan umum yang sering terjadi saat menerapkan konfigurasi ini adalah kegagalan server dalam mengenali direktif akibat modul Apache yang belum aktif atau batasan konfigurasi global (AllowOverride) pada direktori utama server. Untuk memastikan fungsi ini berjalan optimal, pemahaman mendalam mengenai sintaks, prasyarat modul, serta mitigasi keamanan sangat diperlukan.

Prasyarat Sistem dan Modul Apache

Sebelum menambahkan baris handler ke dalam berkas .htaccess, pastikan modul mod_include telah dimuat di tingkat server web Apache. Tanpa modul ini, server akan merespons dengan galat Internal Server Error (500) karena direktif tidak dikenali.

Penerapan Kode dalam Berkas .htaccess

Untuk mengaktifkan SSI pada file berekstensi .shtml atau bahkan file standar .html, tambahkan blok kode berikut ke dalam berkas .htaccess di direktori root situs web Anda:

<IfModule mod_include.c>
    AddType text/html .shtml
    AddHandler server-parsed .shtml
    Options +Includes
</IfModule>

Jika Anda ingin memaksa file berformat .html biasa agar memproses perintah SSI (perhatikan bahwa ini dapat membebani kinerja server jika diterapkan pada semua file statis), gunakan konfigurasi berikut:

<IfModule mod_include.c>
    AddHandler server-parsed .html .htm
    Options +Includes
</IfModule>

Langkah-Langkah Teknis Implementasi

1. Buka atau buat file bernama .htaccess di direktori utama (public_html) situs Anda menggunakan FTP client atau pengelola file hosting.
2. Pastikan direktif AllowOverride All diaktifkan pada konfigurasi virtual host utama server Apache, agar file .htaccess memiliki hak untuk mengubah Options dan Handler.
3. Tempelkan kode konfigurasi AddHandler server-parsed beserta blok Options +Includes di dalam file tersebut.
4. Simpan perubahan dan lakukan uji coba dengan membuat file uji coba (misalnya test.shtml) yang berisi sintaks SSI dasar seperti <!--#echo var="DATE_LOCAL" -->.
5. Akses file tersebut melalui peramban. Jika tanggal dan waktu server muncul, konfigurasi telah berhasil diterapkan.

Troubleshooting Masalah Umum

Kendala yang sering muncul setelah menerapkan konfigurasi ini umumnya berkaitan dengan hak akses atau batasan keamanan server:

• Internal Server Error (500): Biasanya disebabkan oleh direktif Options +Includes yang ditolak oleh server karena pengaturan AllowOverride yang membatasi modifikasi opsi. Solusinya, hubungi penyedia hosting atau sesuaikan konfigurasi httpd.conf / apache2.conf.
• Perintah SSI Ditampilkan作为 Teks Biasa: Hal ini terjadi jika AddHandler server-parsed gagal dieksekusi atau ekstensi file tidak cocok dengan yang didaftarkan. Pastikan modul mod_include aktif di tingkat server.