OpenLiteSpeed secara bawaan tidak mengaktifkan Server Side Includes (SSI) pada direktori virtual secara otomatis demi menjaga performa dan keamanan server. Untuk mengaktifkan dukungan SSI, administrator harus melakukan konfigurasi manual melalui WebAdmin Console OpenLiteSpeed atau memodifikasi file konfigurasi virtual host agar server dapat memproses arahan (directive) seperti #include, #echo, dan #if.
Meskipun OpenLiteSpeed mendukung sebagian besar perintah standar SSI yang biasa ditemukan di Apache mod_include, implementasinya memiliki batasan performa terutama terkait caching dan kompleksitas logika kondisional tingkat lanjut. Berikut adalah rincian kompatibilitas direktif SSI di OpenLiteSpeed:
Tabel Kompatibilitas Direktif SSI di OpenLiteSpeed
| Direktif SSI | Status Dukungan | Keterangan Teknis |
|---|---|---|
#include |
Didukung Penuh | Mendukung file eksternal dengan parameter virtual atau file. |
#echo |
Didukung | Menampilkan variabel lingkungan server dan tanggal. |
#set |
Didukung | Digunakan untuk mendefinisikan variabel kustom dalam halaman. |
#if / #elif / #else / #endif |
Terbatas | Logika kondisional sederhana berfungsi, namun tidak disarankan untuk ekspresi reguler yang kompleks. |
#exec |
Tidak Didukung / Dinonaktifkan | Direktif untuk menjalankan perintah CGI/shell dinonaktifkan secara default demi alasan keamanan. |
Langkah Mengaktifkan SSI di OpenLiteSpeed
Untuk mengaktifkan pemrosesan SSI pada file dengan ekstensi tertentu (misalnya .shtml), ikuti langkah-langkah teknis berikut:
- Login ke OpenLiteSpeed WebAdmin Console (biasanya melalui port
7080). - Navigasi ke menu Virtual Hosts dan pilih virtual host situs Anda.
- Buka tab General, cari bagian General Settings atau pengaturan handler skrip.
- Tambahkan ekstensi file SSI (seperti
shtml) ke dalam handler parsing server atau pastikan modul parse SSI diaktifkan pada level konteks (Context). - Simpan perubahan (Save) dan lakukan Graceful Restart pada server OpenLiteSpeed agar konfigurasi diterapkan.
Contoh Penggunaan Sintaks SSI
Berikut adalah contoh implementasi dasar Server Side Includes untuk menyertakan file header dan footer ke dalam dokumen HTML:
<!--#include virtual="/header.html" -->
<h1>Selamat Datang di Situs Kami</h1>
<p>Halaman ini diproses menggunakan OpenLiteSpeed SSI.</p>
<!--#include virtual="/footer.html" -->Troubleshooting dan Tips Kinerja
Penggunaan SSI dapat memengaruhi efisiensi caching cache engine seperti LSCache. Jika file utama di-cache sementara file yang di-include (`#include`) sering berubah, pengunjung mungkin melihat konten yang tidak sinkron. Pastikan untuk mengatur masa kedaluwarsa cache (TTL) secara tepat atau gunakan AJAX/esi (Edge Side Includes) sebagai alternatif modern jika Anda membutuhkan modularitas konten yang dinamis dan berperforma tinggi di OpenLiteSpeed.