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

Konfigurasi Apache AddHandler Server Parsed (SSI)

Kueri 'Apache Addhandler Server Parsed' merujuk pada konfigurasi web server Apache untuk mengaktifkan fitur Server Side Includes (SSI) menggunakan direktif AddHandler dengan handler internal server-parsed. Konfigurasi ini menginstruksikan Apache untuk memproses file tertentu (biasanya berekstensi .shtml, .html, atau .htm) guna mencari direktif SSI sebelum merendernya ke peramban pengguna.

Secara mendasar, handler server-parsed memetakan tipe MIME internal Apache agar file yang diminta dibaca baris per baris untuk mencari tag SSI seperti <!--#include virtual="file.html" -->. Tanpa konfigurasi ini, tag SSI akan diabaikan oleh server dan dikirimkan mentah ke klien.

Sintaks Dasar dan Blok Konfigurasi

Penerapan direktif ini umumnya dilakukan di dalam file konfigurasi utama Apache (httpd.conf atau apache2.conf), file virtual host, atau melalui berkas .htaccess di direktori root web Anda. Berikut adalah blok kode standar yang wajib diterapkan untuk mengaktifkan pemrosesan SSI.

<Directory "/var/www/html">
    Options +Includes
    AddType text/html .shtml
    AddHandler server-parsed .shtml
</Directory>

Jika Anda hanya ingin menerapkannya secara lokal melalui direktori publik menggunakan file .htaccess, pastikan modul mod_include telah aktif di tingkat server.

# Aktifkan handler server-parsed untuk ekstensi shtml dan html
AddHandler server-parsed .shtml .html

# Pastikan opsi Includes diizinkan pada direktori ini
Options +Includes

Tabel Parameter Komponen SSI & AddHandler

Komponen / Direktif Fungsi Utama Keterangan Teknis
AddHandler Memetakan ekstensi file ke handler internal server. Menghubungkan ekstensi file dengan modul pemroses di Apache.
server-parsed Handler internal milik modul mod_include. Memerintahkan server memindai tag SSI di dalam file sebelum dikirim.
Options +Includes Memberikan izin eksekusi SSI pada direktori tertentu. Wajib diaktifkan, jika tidak, server akan merespons dengan error 500 (Internal Server Error) atau mengabaikan SSI.
AddType Menentukan tipe MIME dari ekstensi file. Memastikan peramban mengenali file sebagai dokumen HTML (text/html).

Langkah Teknis Implementasi di Ubuntu/Debian & CentOS

Untuk memastikan konfigurasi berjalan tanpa hambatan pada lingkungan produksi berbasis Linux, ikuti tahapan administratif berikut:

  1. Aktifkan Modul Include: Pada sistem berbasis Debian/Ubuntu, jalankan perintah terminal sudo a2enmod include untuk mengaktifkan modul mod_include.
  2. Sesuaikan Konfigurasi Virtual Host: Buka file konfigurasi situs Anda (misal: /etc/apache2/sites-available/000-default.conf) dan pastikan direktori tujuan memiliki baris Options +Includes.
  3. Tambahkan Direktif Handler: Masukkan baris AddHandler server-parsed .shtml di dalam blok <Directory> atau file .htaccess.
  4. Uji Sintaks Konfigurasi: Jalankan perintah sudo apache2ctl configtest untuk memastikan tidak ada kesalahan pengetikan sintaks.
  5. Muat Ulang Layanan Apache: Terapkan perubahan dengan perintah sudo systemctl restart apache2 (atau httpd pada CentOS/RHEL).

Troubleshooting dan Kendala Umum

Kesalahan paling sering terjadi saat mengimplementasikan server-parsed adalah munculnya pesan Internal Server Error (500). Hal ini umumnya disebabkan oleh direktif Options +Includes yang tidak diizinkan oleh konfigurasi induk (seringkali karena pengaturan AllowOverride None pada direktori utama Apache yang mengabaikan file .htaccess).

Untuk mengatasinya, ubah pengaturan pada blok direktori utama di konfigurasi server menjadi:

<Directory "/var/www/html">
    Options Indexes FollowSymLinks +Includes
    AllowOverride All
    Require all granted
</Directory>

Selain itu, hindari penggunaan AddHandler server-parsed .html pada situs dengan lalu lintas sangat tinggi tanpa kebutuhan mendesak, karena pemindaian seluruh file HTML untuk mencari tag SSI dapat membebani penggunaan CPU server secara signifikan.

🔍 Orang Lain Juga Mencari Ini