Apache MIME Type SHTML: Konfigurasi & Cara Kerja SSI

Apache MIME type untuk file SHTML (Server Side Includes) didefinisikan secara standar sebagai text/html atau text/x-server-parsed-html, yang memberitahu web server Apache bahwa dokumen tersebut berisi perintah SSI yang harus diproses sebelum dikirimkan ke peramban pengguna. File berformat .shtml, .shtm, atau .stm memungkinkan pengembang menyisipkan konten dokumen lain ke dalam satu halaman web secara dinamis tanpa memerlukan bahasa pemrograman backend yang kompleks seperti PHP atau Python.

Untuk mengaktifkan dukungan SHTML pada server web Apache, administrator sistem harus memastikan modul mod_include aktif dan direktif penanganan MIME type serta handler yang tepat telah dikonfigurasi di dalam berkas konfigurasi utama seperti httpd.conf, apache2.conf, atau melalui berkas .htaccess di tingkat direktori.

Konfigurasi Standar MIME Type SHTML di Apache

Secara default, instalasi standar Apache (seperti pada distribusi Ubuntu/Debian atau CentOS/RHEL) telah memetakan ekstensi file SSI secara otomatis melalui modul tambahan. Namun, jika Anda perlu menambahkannya secara manual, berikut adalah blok kode konfigurasi yang harus disematkan pada server Apache Anda.

# Mengaktifkan AddType dan Handler untuk file .shtml dan .shtm
AddType text/html .shtml
AddOutputFilter INCLUDES .shtml

# Pastikan Options Includes diaktifkan pada direktori web Anda
<Directory "/var/www/html">
    Options +Includes
    AllowOverride None
    Require all granted
</Directory>

Tabel Parameter & Direktif Apache untuk SHTML

Berikut adalah rincian parameter penting yang berkaitan dengan konfigurasi MIME type dan eksekusi file SHTML pada server Apache:

Direktif / Komponen Nilai Standar Fungsi Utama
MIME Type text/html Menentukan tipe konten agar peramban merendernya sebagai dokumen HTML standar.
Output Filter INCLUDES Memerintahkan Apache untuk memindai tag SSI (seperti #include) sebelum merespons permintaan.
Directory Option +Includes Izin tingkat direktori agar server mengizinkan pemrosesan Server Side Includes.
Handler Alternatif server-parsed Menghubungkan ekstensi file tertentu agar diparsing langsung oleh mesin SSI Apache.

Contoh Penggunaan Tag SSI dalam File .shtml

Setelah konfigurasi MIME type dan handler selesai, Anda dapat membuat file dengan ekstensi .shtml dan menyisipkan sintaks SSI dasar, misalnya untuk menyertakan file navigasi atau footer secara berulang pada banyak halaman.

<!--#include virtual="/header.html" -->
<h1>Selamat Datang di Situs Kami</h1>
<p>Halaman ini menggunakan teknologi Server Side Includes (SSI) pada Apache.</p>
<!--#echo var="DATE_LOCAL" -->
<!--#include virtual="/footer.html" -->

Troubleshooting Masalah SHTML di Apache

Jika file .shtml Anda diunduh sebagai file alih-alih dirender sebagai halaman web, atau jika tag SSI muncul mentah di peramban, lakukan langkah-langkah pemeriksaan berikut:

  1. Periksa apakah modul include telah aktif dengan menjalankan perintah a2enmod include pada sistem berbasis Debian/Ubuntu, lalu restart Apache menggunakan sudo systemctl restart apache2.
  2. Pastikan direktif Options +Includes tidak ditimpa oleh konfigurasi blok <Directory> lainnya yang menggunakan tanda minus (-Includes).
  3. Verifikasi bahwa baris AddType text/html .shtml sudah terbaca dengan baik di dalam konfigurasi virtual host aktif.