Contoh Penggunaan SSI Include Virtual pada Server Web

Server Side Includes (SSI) adalah bahasa scripting sisi server sederhana yang digunakan hampir secara eksklusif untuk web, berfungsi menyisipkan isi satu atau beberapa file ke dalam halaman web pada server web menggunakan direktif #include. Perintah ini sangat berguna untuk menyisipkan elemen umum seperti header, footer, menu navigasi, atau timestamp ke dalam halaman statis tanpa memerlukan kerangka kerja aplikasi yang kompleks.

Dalam implementasinya, elemen include dapat menentukan file yang akan disertakan menggunakan atribut file atau atribut virtual. Atribut virtual menggunakan jalur virtual (virtual path) ke suatu sumber daya, termasuk skrip CGI, yang memungkinkan fleksibilitas lebih besar dalam manajemen struktur direktori server.

Perbandingan Atribut Include pada SSI

Berikut adalah tabel perbandingan antara atribut file dan virtual dalam perintah SSI include:

Atribut Deskripsi Jalur Cakupan Akses Contoh Penggunaan
file Jalur relatif terhadap direktori dokumen saat ini (relative path). Terbatas pada direktori lokal dan sub-direktori di bawahnya. <!--#include file="includes/footer.html" -->
virtual Jalur virtual (virtual path) berbasis dokumen root server atau skrip CGI. Dapat mengakses sumber daya lintas direktori dalam satu domain dan skrip CGI. <!--#include virtual="/cgi-bin/counter.cgi" -->

Contoh Penerapan Virtual Path

Ketika Anda ingin menyisipkan file footer atau header yang terletak di direktori root situs web tanpa mempedulikan di sub-folder mana file HTML pemanggil berada, atribut virtual menjadi pilihan utama. Berikut adalah contoh kode penulisan SSI include virtual di dalam dokumen HTML:

<!-- Menyisipkan menu navigasi utama menggunakan virtual path -->
<!--#include virtual="/navigation.html" -->

<!-- Konten Utama Halaman Web -->
<div>
    <h1>Selamat Datang di Situs Kami</h1>
    <p>Halaman ini menggunakan Server Side Includes untuk memuat elemen berulang secara dinamis.</p>
</div>

<!-- Menyisipkan footer bersama dengan virtual path -->
<!--#include virtual="/includes/footer.html" -->

Langkah Teknis Pengaktifan SSI di Server

Agar perintah SSI seperti #include virtual dapat diproses oleh server web (seperti Apache), pastikan konfigurasi server telah mengizinkan eksekusi SSI. Berikut adalah langkah-langkah teknis pengaturannya:

  • Konfigurasi Apache (.htaccess atau httpd.conf): Tambahkan modul atau opsi handler untuk mengizinkan parsing SSI pada ekstensi file tertentu (biasanya .shtml atau diaktifkan pada file .html).
    Options +Includes
    AddType text/html .shtml
    AddOutputFilter INCLUDES .shtml
  • Pembuatan File Komponen: Buat file terpisah yang akan dipanggil, contohnya footer.html yang berisi satu struktur footer standar untuk seluruh situs.
  • Penyisipan Direktif: Letakkan baris perintah <!--#include virtual="..." --> pada posisi yang diinginkan di dalam dokumen HTML atau SHTML utama.
  • Pengujian Server: Unggah file ke server yang mendukung SSI dan akses melalui browser untuk memastikan konten tersisip dengan sempurna ke dalam aliran respons (response stream) klien.