💡 ULASAN & REFERENSI • DIPERBARUI: 21 October 2026 • REDAKSI AZWINN

Konfigurasi SSI Apache: Panduan Lengkap & Contoh Kode

Konfigurasi Server Side Includes (SSI) pada web server Apache memungkinkan pengembang web untuk menyisipkan konten dokumen lain ke dalam sebuah halaman web secara dinamis tanpa harus menggunakan bahasa pemrograman tingkat tinggi seperti PHP atau Python. Untuk mengaktifkan SSI di Apache, Anda harus memastikan modul include aktif, menambahkan direktif konfigurasi pada berkas konfigurasi utama atau berkas .htaccess, serta mengizinkan eksekusi Includes pada direktori web terkait.

Langkah pertama yang esensial adalah memastikan modul mod_include.so dimuat oleh Apache. Pada sistem berbasis Ubuntu atau Debian, hal ini dapat dilakukan melalui utilitas manajemen modul bawaan, diikuti dengan penyesuaian izin direktori dan konfigurasi handler agar server mengenali ekstensi berkas yang akan memproses perintah SSI.

Langkah-Langkah Konfigurasi SSI di Apache

  1. Aktifkan Modul Include: Jalankan perintah terminal untuk mengaktifkan modul include pada Apache (contoh: sudo a2enmod include pada Ubuntu/Debian).
  2. Modifikasi Konfigurasi Virtual Host: Tambahkan direktif Options +Includes dan AddOutputFilter INCLUDES pada blok direktori Virtual Host Anda.
  3. Sesuaikan Berkas .htaccess (Opsional): Jika Anda tidak memiliki akses root ke server, gunakan berkas .htaccess dengan catatan direktori utama (main server configuration) mengizinkan override Options dan FileInfo.
  4. Uji Coba Berkas SSI: Buat berkas dengan ekstensi .shtml dan masukkan sintaks SSI dasar untuk memastikan konfigurasi berjalan dengan sempurna.

Contoh Konfigurasi Virtual Host Apache

Berikut adalah contoh blok konfigurasi pada berkas Virtual Host Apache (biasanya terletak di /etc/apache2/sites-available/000-default.conf atau direktori setara) untuk mengaktifkan SSI:

<Directory "/var/www/html">
    Options Indexes FollowSymLinks +Includes
    AllowOverride All
    Require all granted
    AddType text/html .shtml
    AddOutputFilter INCLUDES .shtml
</Directory>

Tabel Arahan Konfigurasi SSI

Direktif ApacheFungsi UtamaContoh Penggunaan
Options +IncludesMengaktifkan fitur Server Side Includes pada direktori tertentu.Options Indexes FollowSymLinks +Includes
AddType text/html .shtmlMemberitahu Apache bahwa berkas berakhiran .shtml adalah dokumen HTML.AddType text/html .shtml
AddOutputFilter INCLUDESMemaksa Apache melewatkan berkas melalui filter SSI sebelum dikirim ke peramban.AddOutputFilter INCLUDES .shtml .html
XBitHack OnMengaktifkan SSI berdasarkan bit eksekusi berkas (permission +x) tanpa mengubah ekstensi.XBitHack On

Sintaks Dasar Perintah SSI

Setelah konfigurasi server selesai, Anda dapat menyisipkan berbagai direktif SSI langsung ke dalam dokumen HTML atau SHTML Anda. Perintah SSI ditulis menggunakan format komentar HTML khusus.

<!--#include virtual="header.html" -->
<h1>Selamat Datang di Situs Kami</h1>
<p>Tanggal hari ini: <!--#echo var="DATE_LOCAL" --></p>
<!--#include virtual="footer.html" -->

Troubleshooting Masalah Umum SSI

Jika perintah SSI tidak dieksekusi oleh server dan muncul sebagai komentar biasa di peramban pengguna, periksa beberapa hal berikut:

  • Pastikan modul include benar-benar telah dimuat dan Apache telah direstart (sudo systemctl restart apache2).
  • Periksa apakah direktori tempat berkas berada memiliki opsi +Includes yang diizinkan (tidak ditimpa oleh konfigurasi AllowOverride None).
  • Periksa log error Apache (biasanya di /var/log/apache2/error.log) untuk mendeteksi kesalahan sintaks konfigurasi.

🔍 Orang Lain Juga Mencari Ini