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

Cara Kerja & Konfigurasi Apache AddOutputFilter Includes

Direktif AddOutputFilter dengan argumen INCLUDES pada server web Apache digunakan untuk mengaktifkan Server Side Includes (SSI). Fitur ini memungkinkan server memproses perintah khusus (seperti menyertakan file lain, menampilkan tanggal, atau variabel lingkungan) di dalam file HTML sebelum dikirimkan ke peramban pengguna. Penulisan yang benar pada konfigurasi Apache adalah menggunakan huruf kapital untuk nama filternya, yaitu INCLUDES.

Untuk menerapkan fungsi ini, modul mod_include harus sudah aktif di dalam server Apache Anda. Tanpa modul tersebut, server akan mengembalikan galat konfigurasi atau mengabaikan instruksi filter yang diberikan.

Sintaks dan Cara Konfigurasi

Penerapan direktif ini dapat dilakukan di dalam berkas konfigurasi utama Apache (seperti httpd.conf atau apache2.conf) maupun di dalam berkas .htaccess pada direktori web Anda. Berikut adalah contoh blok kode konfigurasi yang benar untuk mengaktifkan SSI pada ekstensi berkas tertentu.

<FilesMatch "\.(html|shtml)$">
    AddOutputFilter INCLUDES .html .shtml
</FilesMatch>

Options +Includes

Langkah-Langkah Teknis Implementasi

  1. Pastikan modul mod_include aktif pada server Apache Anda dengan menjalankan perintah terminal seperti sudo a2enmod include pada sistem operasi berbasis Debian/Ubuntu.
  2. Buka berkas konfigurasi virtual host atau berkas .htaccess di direktori situs web Anda menggunakan teks editor.
  3. Tambahkan izin direktori dengan memastikan opsi Includes aktif, contohnya: Options Indexes FollowSymLinks Includes.
  4. Tambahkan baris direktif AddOutputFilter INCLUDES html untuk menerapkan pemrosesan SSI pada file berekstensi .html.
  5. Simpan berkas konfigurasi dan lakukan pengujian ulang sintaks Apache dengan perintah sudo apachectl configtest.
  6. Muat ulang layanan server web menggunakan perintah sudo systemctl restart apache2 atau httpd.

Tabel Parameter dan Penjelasan Konfigurasi SSI

Komponen Jenis Fungsi Utama
AddOutputFilter Direktif Apache Menetapkan filter keluaran yang harus diproses pada data sebelum dikirim ke klien.
INCLUDES Nama Filter Memerintahkan modul mod_include untuk memindai tag SSI (seperti #include).
Options +Includes Pengaturan Direktori Memberikan izin kepada direktori tersebut untuk menjalankan perintah Server Side Includes.
.shtml / .html Ekstensi Berkas Target format berkas yang akan dievaluasi oleh filter Apache sebelum dirender.

Troubleshooting dan Tips Lapangan

Jika tag SSI seperti <!--#include virtual="header.html" --> muncul sebagai teks biasa di peramban dan tidak mengeksekusi file yang dimaksud, periksa beberapa hal berikut:

  • Pastikan direktif Options +Includes diizinkan pada kontainer <Directory> di konfigurasi utama. Seringkali konfigurasi AllowOverride All diperlukan jika Anda menggunakan berkas .htaccess.
  • Perhatikan penulisan sintaks tag SSI. Spasi di dalam tanda kurung siku pembuka dan penutup sangat krusial (misalnya harus tepat <!--#... -->).
  • Penggunaan SSI pada seluruh file .html dapat menurunkan performa peladen karena setiap file harus dipindai terlebih dahulu oleh Apache. Batasi hanya pada direktori atau file tertentu yang membutuhkan fitur dinamis tersebut.

🔍 Orang Lain Juga Mencari Ini