Tutorial Mengaktifkan Server Side Includes (SSI) via .htaccess

Cara Mengaktifkan SHTML via .htaccess

Untuk mengaktifkan Server Side Includes (SSI) pada server Apache, Anda perlu menambahkan instruksi spesifik ke dalam file .htaccess agar server mengenali file dengan ekstensi .shtml atau .html sebagai file yang dapat diproses oleh modul mod_include. Tanpa konfigurasi ini, perintah SSI seperti <!--#include virtual="file.html" --> tidak akan dieksekusi oleh server.

Sintaks Konfigurasi .htaccess

Salin kode berikut ke dalam file .htaccess di direktori root atau folder yang dituju:

AddType text/html .shtml
AddHandler server-parsed .shtml

<IfModule mod_include.c>
    Options +Includes
</IfModule>

Penjelasan Teknis Parameter

PerintahFungsi
AddType text/html .shtmlMemberitahu browser bahwa file .shtml adalah dokumen HTML.
AddHandler server-parsed .shtmlMenginstruksikan Apache untuk memproses file .shtml melalui handler SSI.
Options +IncludesMengaktifkan fitur SSI pada direktori tersebut.

Langkah Implementasi

  1. Pastikan modul mod_include telah aktif di sisi server (hubungi penyedia hosting jika terjadi error 500).
  2. Buat atau edit file bernama .htaccess di direktori utama website Anda.
  3. Masukkan kode di atas dan simpan perubahan.
  4. Uji coba dengan membuat file test.shtml berisi kode: <!--#echo var="DATE_LOCAL" -->.
  5. Akses file tersebut melalui browser; jika muncul tanggal dan waktu server, maka konfigurasi berhasil.

Troubleshooting Umum

Jika Anda menemui kendala, perhatikan poin berikut:

  • Error 500 Internal Server Error: Biasanya terjadi karena modul mod_include tidak diizinkan oleh konfigurasi utama server (httpd.conf). Pastikan AllowOverride All telah diatur pada direktori tersebut.
  • SSI Tidak Berjalan di .html: Jika Anda ingin SSI berjalan di file .html biasa, tambahkan baris AddHandler server-parsed .html ke dalam .htaccess Anda.
  • Keamanan: Hindari penggunaan Options +IncludesNOEXEC jika Anda tidak memerlukan eksekusi perintah shell (seperti exec) untuk alasan keamanan server.