Konfigurasi SSI pada OpenLiteSpeed
Server Side Includes (SSI) pada OpenLiteSpeed tidak diaktifkan secara default untuk alasan keamanan dan performa. Untuk mengaktifkannya, Anda harus memodifikasi konfigurasi pada level Virtual Host melalui WebAdmin Console atau file konfigurasi langsung. SSI memungkinkan Anda menyisipkan konten dinamis seperti tanggal atau file lain ke dalam dokumen HTML statis sebelum dikirim ke browser.
Langkah Konfigurasi via WebAdmin Console
Ikuti prosedur berikut untuk mengaktifkan dukungan SSI pada Virtual Host Anda:
- Login ke OpenLiteSpeed WebAdmin Console (biasanya port 7080).
- Navigasi ke menu Virtual Hosts dan pilih Virtual Host yang ingin dikonfigurasi.
- Buka tab General, lalu cari bagian Script Handler.
- Klik Add pada tabel Script Handler.
- Isi parameter berikut:
- Suffix: shtml
- Handler Type: server-side-include
- Handler Name: server-side-include
- Simpan perubahan dan lakukan Graceful Restart pada server OpenLiteSpeed.
Tabel Parameter Konfigurasi SSI
| Parameter | Nilai | Keterangan |
|---|---|---|
| Suffix | shtml | Ekstensi file yang memproses SSI |
| Handler Type | server-side-include | Tipe handler internal OLS |
| Handler Name | server-side-include | Nama referensi handler |
Implementasi pada File .htaccess
Jika Anda tidak memiliki akses ke WebAdmin Console, Anda dapat mengaktifkan SSI melalui file .htaccess di direktori root website Anda dengan menambahkan baris berikut:
AddType text/html .shtml
AddOutputFilter INCLUDES .shtml
Options +IncludesPastikan modul mod_include telah dimuat oleh server. Jika Anda menggunakan file .html biasa dan ingin memproses SSI di dalamnya, tambahkan baris berikut ke .htaccess:
AddOutputFilter INCLUDES .htmlTroubleshooting dan Tips
Jika SSI tidak berjalan setelah konfigurasi, periksa hal berikut:
- File Permissions: Pastikan file memiliki izin baca (read) yang benar oleh user web server.
- Syntax Error: Pastikan sintaks SSI di dalam file HTML benar, contoh:
<!--#include virtual="/header.html" -->. - Log Error: Periksa file log di
/usr/local/lsws/logs/error.loguntuk melihat apakah ada kegagalan eksekusi handler. - Caching: Jika Anda menggunakan plugin cache atau LSCache, pastikan untuk melakukan purge all setelah mengubah konfigurasi SSI agar perubahan segera terlihat.
Penggunaan SSI yang berlebihan pada halaman yang sangat dinamis dapat membebani CPU server. Gunakan SSI hanya untuk elemen statis yang berulang seperti header, footer, atau timestamp.