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

Cara Setting AddOutputFilter Includes di Htaccess

Mengaktifkan AddOutputFilter Includes pada file .htaccess adalah langkah teknis untuk mengizinkan server web Apache memproses Server Side Includes (SSI) pada ekstensi file tertentu. SSI memungkinkan Anda menyertakan isi dari file lain (seperti header, footer, atau navigasi) ke dalam sebuah dokumen HTML tanpa harus menulis ulang kode yang sama di setiap halaman.

Untuk menerapkan fungsi ini secara optimal, server Apache Anda harus memiliki modul mod_include yang aktif. Jika modul tersebut tidak aktif di tingkat server utama, pengaturan di file .htaccess akan memicu error HTTP 500 (Internal Server Error). Di bawah ini adalah panduan implementasi teknis beserta parameter konfigurasi yang wajib dipasang.

Sintaks Dasar Penggunaan

Berikut adalah kode konfigurasi nyata yang harus Anda tempatkan di dalam file .htaccess pada direktori root web Anda:

<IfModule mod_include.c>
    AddOutputFilterByType INCLUDES text/html
    AddHandler server-parsed .html .htm
</IfModule>

Atau menggunakan direktif AddOutputFilter secara spesifik berdasarkan ekstensi file:

AddType text/html .shtml
AddOutputFilter INCLUDES .shtml

Tabel Parameter & Komponen Konfigurasi SSI

Direktif / Modul Fungsi Utama Catatan Implementasi
mod_include Modul Apache inti untuk pemrosesan SSI Harus diaktifkan oleh administrator server (hosting)
AddOutputFilter INCLUDES Menambahkan filter output SSI ke ekstensi file tertentu Biasanya diterapkan pada file dengan ekstensi .shtml
AddOutputFilterByType Memfilter output berdasarkan tipe MIME (misal: text/html) Lebih efisien karena tidak perlu mengubah ekstensi file menjadi .shtml
Options +Includes Mengizinkan eksekusi SSI di direktori tersebut Wajib ditambahkan jika server memblokir eksekusi secara default

Langkah-Langkah Implementasi Teknis

  1. Periksa Akses Server: Pastikan Anda memiliki akses untuk mengedit file .htaccess di direktori publik situs web Anda (biasanya public_html).
  2. Tambahkan Izin Opsi: Tambahkan baris Options +Includes di awal file .htaccess untuk memastikan direktori memberikan izin eksekusi SSI.
  3. Terapkan Filter Output: Masukkan baris kode AddOutputFilter INCLUDES .html atau gunakan AddOutputFilterByType agar file HTML biasa dapat memproses perintah SSI.
  4. Uji Coba Skrip SSI: Buat file uji coba dengan menyertakan tag SSI standar, contohnya: <!--#include virtual="header.html" -->.
  5. Verifikasi di Browser: Akses halaman tersebut melalui browser untuk memastikan file eksternal berhasil dimuat secara dinamis.

Troubleshooting Error 500

Kendala paling sering terjadi saat mengaktifkan pengaturan ini adalah munculnya Internal Server Error (HTTP 500). Hal ini disebabkan oleh beberapa faktor spesifik di tingkat server:

  • AllowOverride All Belum Aktif: Konfigurasi utama Apache di server (seperti httpd.conf atau apache2.conf) melarang file .htaccess mengubah direktif Options. Pastikan administrator mengubah AllowOverride None menjadi AllowOverride All pada blok direktori situs Anda.
  • Modul Belum Terpasang: Modul mod_include belum dikompilasi atau diaktifkan pada server web (terutama pada lingkungan VPS atau dedicated server berbasis Ubuntu/CentOS).

🔍 Orang Lain Juga Mencari Ini