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

Cara Include File HTML di Apache Server Menggunakan SSI

Cara paling efisien untuk menyertakan (include) file HTML di dalam file HTML lainnya pada web server Apache adalah dengan memanfaatkan fitur bawaan bernama Server Side Includes (SSI). Dengan SSI, Anda tidak perlu mengubah seluruh halaman statis saat ada perubahan pada elemen berulang seperti header atau footer, cukup dengan satu baris direktif <!--#include virtual="namafile.html" -->.

Langkah utama untuk mengaktifkan dan menggunakan SSI di Apache mencakup pengaktifan modul include_module, penambahan konfigurasi handler pada file konfigurasi virtual host atau berkas .htaccess, serta penulisan sintaks direktif yang tepat pada dokumen web Anda.

1. Memastikan Modul Apache Aktif

Sebelum menggunakan SSI, pastikan modul include pada server Apache Anda telah aktif. Pada sistem berbasis Ubuntu/Debian, Anda dapat mengaktifkannya melalui terminal menggunakan perintah:

sudo a2enmod include
sudo systemctl restart apache2

Untuk lingkungan Windows menggunakan XAMPP, buka file httpd.conf, cari baris LoadModule include_module modules/mod_include.so, dan pastikan tanda pagar (#) di depannya telah dihapus.

2. Konfigurasi .htaccess untuk Mengizinkan SSI

Agar server Apache memproses perintah SSI di dalam file ber-ekstensi .html atau .htm, Anda perlu menambahkan aturan konfigurasi. Buat atau edit file .htaccess di direktori root website Anda, lalu tambahkan baris kode berikut:

Options +Includes
AddType text/html .html
AddOutputFilter INCLUDES .html

Tabel Matriks Konfigurasi SSI Apache

Direktif Apache Fungsi Utama Catatan Implementasi
Options +Includes Mengizinkan eksekusi Server Side Includes pada direktori tersebut. Wajib diletakkan di file konfigurasi utama atau .htaccess.
AddType text/html .html Memberitahu server bahwa file .html diproses sebagai dokumen HTML. Dibutuhkan agar browser mengenali output dengan benar.
AddOutputFilter INCLUDES .html Memfilter output file .html untuk memindai tag SSI. Inti dari pemrosesan tag <!--#include ... -->.

3. Menulis Sintaks Include pada File HTML

Setelah konfigurasi server selesai, Anda dapat menyisipkan file lain (misalnya header.html atau footer.html) ke dalam file utama (misalnya index.html). Gunakan format penulisan berikut:

<!DOCTYPE html>
<html lang="id">
<head>
    <meta charset="UTF-8">
    <title>Halaman Utama</title>
</head>
<body>

    <!-- Menyertakan file header -->
    <!--#include virtual="/header.html" -->

    <main>
        <h1>Selamat Datang di Website Kami</h1>
        <p>Konten utama halaman ini berada di sini.</p>
    </main>

    <!-- Menyertakan file footer -->
    <!--#include virtual="/footer.html" -->

</body>
</html>

Troubleshooting Masalah Umum SSI

Jika file yang di-include tidak tampil atau menghasilkan pesan error [an error occurred while processing this directive], periksa beberapa hal berikut:

  • Path File Salah: Atribut virtual menggunakan path relatif terhadap root dokumen web Anda (diawali garis miring /), sedangkan atribut file menggunakan path relatif terhadap file yang sedang aktif.
  • Izin Akses (Permissions): Pastikan file yang dipanggil memiliki izin baca yang valid untuk user server web (seperti www-data).
  • Dukungan Server: Pastikan hosting Anda mengizinkan penggunaan Options +Includes di dalam file .htaccess (beberapa shared hosting mengetatkan aturan keamanan ini).

🔍 Orang Lain Juga Mencari Ini