Tutorial SSI Apache Server: Cara Mengaktifkan dan Implementasi

Konfigurasi SSI pada Apache Server

Server Side Includes (SSI) adalah mekanisme sederhana untuk menyisipkan konten dinamis ke dalam file HTML statis sebelum dikirim ke browser. Untuk mengaktifkan SSI pada Apache, Anda harus memastikan modul mod_include aktif dan direktori mengizinkan eksekusi perintah SSI melalui direktif Options +Includes.

Langkah Aktivasi Modul

Pada sistem berbasis Debian/Ubuntu, gunakan perintah berikut untuk mengaktifkan modul:

sudo a2enmod include
sudo systemctl restart apache2

Konfigurasi Virtual Host atau .htaccess

Setelah modul aktif, Anda perlu mengonfigurasi Apache agar memproses file dengan ekstensi tertentu (biasanya .shtml atau .html) sebagai SSI. Tambahkan baris berikut ke dalam file konfigurasi Virtual Host atau file .htaccess di direktori root web Anda:

<Directory /var/www/html>
    Options +Includes
    AddType text/html .shtml
    AddOutputFilter INCLUDES .shtml
</Directory>

Sintaks Dasar SSI

Setelah konfigurasi selesai, Anda dapat menyisipkan file lain ke dalam dokumen HTML menggunakan perintah include. Berikut adalah contoh penggunaan:

<!--#include virtual="/header.html" -->
<p>Konten utama halaman.</p>
<!--#include virtual="/footer.html" -->
Perintah SSIFungsi
#includeMenyisipkan konten dari file lain
#echoMenampilkan variabel lingkungan (seperti tanggal)
#execMenjalankan perintah shell (perlu hati-hati)
#configMengatur format tanggal atau pesan error

Troubleshooting Umum

Jika SSI tidak berjalan, periksa hal berikut:

  • Pastikan direktif AllowOverride All sudah diatur pada konfigurasi utama Apache agar file .htaccess dapat dibaca.
  • Periksa izin file (file permission); pastikan user www-data memiliki akses baca ke file yang akan di-include.
  • Cek log error Apache di /var/log/apache2/error.log untuk melihat pesan kesalahan spesifik terkait parsing SSI.