Cara Enable SSI Apache di .htaccess (Langkah Mudah)

Untuk mengaktifkan Server Side Includes (SSI) pada server web Apache menggunakan file .htaccess, Anda perlu menambahkan arahan modul mod_include serta menentukan ekstensi file yang akan memproses SSI (seperti .shtml atau .html). Langkah ini memungkinkan Anda menyertakan file eksternal—seperti header, footer, atau menu navigasi—ke dalam halaman web secara dinamis tanpa menggunakan bahasa pemrograman server seperti PHP.

Pastikan modul include_module (mod_include) sudah aktif di konfigurasi server utama Apache Anda sebelum menerapkan aturan ini di tingkat direktori.

Sintaks Kode .htaccess untuk Mengaktifkan SSI

Salin blok kode berikut ke dalam file .htaccess di direktori root situs web Anda:

# Mengaktifkan eksekusi SSI untuk file .shtml dan .html
AddType text/html .shtml
AddHandler server-parsed .shtml

# Opsional: Jika ingin SSI berjalan di file .html standar
AddHandler server-parsed .html

# Mengizinkan eksekusi SSI dan perintah eksekusi (opsional)
Options +Includes

Tabel Konfigurasi Direktif SSI Apache

Direktif Apache Fungsi Utama Catatan Penerapan
AddType text/html .shtml Menetapkan tipe MIME untuk file beresolusi SSI. Wajib ada agar browser membaca file dengan benar.
AddHandler server-parsed Memberitahu Apache untuk memproses file melalui handler SSI. Inti dari eksekusi perintah SSI di server.
Options +Includes Memberikan izin direktori untuk menjalankan fungsi SSI. Bergantung pada konfigurasi AllowOverride di httpd.conf.

Langkah-Langkah Implementasi Teknis

  1. Buka File Manager atau FTP: Akses direktori root situs web Anda (biasanya di public_html).
  2. Cek atau Buat .htaccess: Cari file bernama .htaccess. Jika belum ada, buat file baru dengan nama tersebut.
  3. Tempel Kode Konfigurasi: Masukkan kode di atas ke bagian paling atas atau bawah file .htaccess, lalu simpan.
  4. Uji Coba File SSI: Buat file uji coba dengan nama test.shtml dan masukkan sintaks SSI sederhana: <!--#echo var="DATE_LOCAL" -->.
  5. Verifikasi di Browser: Akses URL file tersebut melalui browser. Jika tanggal dan waktu server muncul, maka SSI berhasil diaktifkan.

Troubleshooting Masalah Umum

Jika setelah memasang kode di atas halaman web menampilkan error 500 Internal Server Error, penyebab umumnya adalah:

  • Konfigurasi Options +Includes diblokir oleh konfigurasi utama server (httpd.conf atau apache2.conf) melalui direktif AllowOverride. Pastikan AllowOverride All atau AllowOverride Options diaktifkan untuk direktori tersebut.
  • Modul mod_include belum aktif di tingkat server Apache. Anda harus mengaktifkannya melalui terminal menggunakan perintah sudo a2enmod include (untuk Ubuntu/Debian) lalu restart Apache dengan sudo systemctl restart apache2.