Cara Setting SSI di Apache Web Server Lengkap

Mengaktifkan Server Side Includes (SSI) pada Apache web server memerlukan modifikasi konfigurasi utama atau file .htaccess agar server mengenali ekstensi file tertentu seperti .shtml dan memproses direktif SSI di dalamnya. SSI memungkinkan penyisipan konten file lain ke dalam sebuah halaman web secara dinamis tanpa menggunakan bahasa pemrograman berat.

Langkah paling utama dalam mengaktifkan SSI di Apache adalah memastikan modul include aktif, lalu mendefinisikan handler dan opsi Includes pada blok direktori server. Berikut adalah tabel ringkasan direktif utama yang wajib dipahami sebelum melakukan konfigurasi:

Direktif Apache Fungsi Utama Contoh Penerapan
LoadModule include_module Mengaktifkan modul mod_include pada Apache. LoadModule include_module modules/mod_include.so
Options +Includes Memberikan izin direktori untuk memproses SSI. Options Indexes FollowSymLinks Includes
AddType text/html .shtml Menentukan tipe MIME untuk file ber-ekstensi SSI. AddType text/html .shtml
AddOutputFilter INCLUDES Memfilter output agar direktif SSI dieksekusi server. AddOutputFilter INCLUDES shtml

Langkah-Langkah Mengaktifkan SSI di Apache

Ikuti prosedur teknis di bawah ini untuk mengonfigurasi SSI pada server Apache berbasis Linux (Ubuntu/Debian atau CentOS/RHEL):

1. Mengaktifkan Modul Include

Bagi pengguna Ubuntu atau Debian, modul include biasanya sudah terinstal namun mungkin belum aktif. Jalankan perintah berikut melalui terminal:

sudo a2enmod include
sudo systemctl restart apache2

2. Mengonfigurasi Virtual Host atau Direktori

Buka file konfigurasi Virtual Host Anda (biasanya terletak di /etc/apache2/sites-available/000-default.conf atau direktori konfigurasi server Anda). Tambahkan baris Options +Includes dan handler output pada blok <Directory>:

<Directory /var/www/html>
    Options Indexes FollowSymLinks Includes
    AllowOverride All
    Require all granted
    AddType text/html .shtml
    AddOutputFilter INCLUDES .shtml
</Directory>

3. Menggunakan .htaccess sebagai Alternatif

Jika Anda tidak memiliki akses root ke file konfigurasi utama Apache, Anda dapat mengaktifkannya melalui file .htaccess di direktori public web Anda dengan menambahkan baris kode berikut:

Options +Includes
AddType text/html .shtml
AddOutputFilter INCLUDES .shtml

Contoh Penggunaan Script SSI

Setelah konfigurasi selesai, buatlah sebuah file baru dengan nama index.shtml di dalam direktori web Anda. Masukkan sintaks SSI dasar untuk menguji apakah server berhasil memprosesnya:

<html>
<head>
    <title>Tes SSI Apache</title>
</head>
<body>
    <h1>Selamat Datang di Website Kami</h1>
    <p>Halaman ini dimuat pada: <!--#echo var="DATE_LOCAL" --></p>
    <!--#include virtual="footer.html" -->
</body>
</html>

Troubleshooting Masalah Umum SSI

Jika direktif SSI tidak berjalan dan hanya menampilkan teks mentah di browser, periksa beberapa hal berikut:

  • Ekstensi File: Pastikan file menggunakan ekstensi .shtml, bukan .html, kecuali Anda menambahkan konfigurasi khusus agar file .html memproses SSI (tidak disarankan karena masalah performa).
  • Log Error: Periksa log error Apache di /var/log/apache2/error.log untuk melihat apakah ada kesalahan sintaks konfigurasi direktori.
  • AllowOverride: Jika menggunakan .htaccess, pastikan konfigurasi utama Apache pada bagian Directory memiliki setelan AllowOverride All atau AllowOverride Options.