Cara Menggunakan AddOutputfilter Includes Apache

Arahan AddOutputfilter Includes pada server web Apache digunakan untuk mengaktifkan pemrosesan Server Side Includes (SSI) melalui modul mod_include. Dengan direktif ini, server akan memindai file untuk mencari arahan SSI khusus seperti <!--#include virtual="file.html" --> sebelum mengirimkannya ke browser pengunjung.

Secara default, Apache tidak memproses SSI pada file dengan ekstensi .html atau .htm demi alasan performa. Untuk mengaktifkannya pada ekstensi file tertentu, direktif ini ditempatkan di dalam file konfigurasi virtual host, direktori, atau file .htaccess.

Sintaks Dasar dan Penggunaan

Sintaks umum untuk menambahkan filter output SSI pada Apache adalah sebagai berikut:

AddOutputfilter Includes shtml html

Kode di atas menginstruksikan Apache agar menerapkan filter SSI pada file yang memiliki ekstensi .shtml dan .html. Agar modul ini berfungsi dengan baik, pastikan modul include_module (mod_include) telah aktif di lingkungan server Apache Anda.

Tabel Parameter dan Konfigurasi Direktif

Langkah-Langkah Implementasi dalam .htaccess

1. Buka atau buat file bernama .htaccess di direktori root web Anda menggunakan teks editor.
2. Pastikan direktori tersebut memiliki izin untuk menjalankan SSI dengan menambahkan blok Options jika diperlukan, atau pastikan konfigurasi utama server mengizinkannya.
3. Tambahkan baris kode untuk mengaktifkan filter output SSI pada ekstensi file yang diinginkan.
4. Simpan file dan lakukan pengujian melalui browser atau utilitas baris perintah seperti curl.

Berikut adalah blok kode lengkap yang biasa digunakan di dalam file .htaccess:

<IfModule mod_include.c>
    AddOutputfilter Includes html shtml
    Options +Includes
</IfModule>

Troubleshooting dan Kendala Umum

Jika setelah menerapkan konfigurasi di atas file SSI Anda tetap tidak terproses (misalnya teks tag #include muncul begitu saja di browser), periksa beberapa hal berikut:

• Modul Belum Aktif: Pastikan mod_include aktif pada server Apache. Pada Ubuntu/Debian, aktifkan dengan perintah sudo a2enmod include lalu restart Apache.
• Bentrok dengan Options: Konfigurasi AllowOverride All harus diaktifkan pada file konfigurasi utama Apache (seperti apache2.conf atau httpd.conf) agar pengaturan Options +Includes di dalam .htaccess diizinkan.
• Masalah Ekstensi: Pastikan ekstensi file yang Anda gunakan sesuai dengan yang didefinisikan pada baris AddOutputfilter.