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.htmlmemproses SSI (tidak disarankan karena masalah performa). - Log Error: Periksa log error Apache di
/var/log/apache2/error.loguntuk melihat apakah ada kesalahan sintaks konfigurasi direktori. - AllowOverride: Jika menggunakan
.htaccess, pastikan konfigurasi utama Apache pada bagianDirectorymemiliki setelanAllowOverride AllatauAllowOverride Options.