Cara paling ampuh untuk mem-parse file SHTML (Server Side Includes) di XAMPP adalah dengan mengaktifkan modul include_module di dalam file konfigurasi utama Apache yaitu httpd.conf, lalu menambahkan aturan pemetaan tipe handler untuk ekstensi file .shtml. Secara default, server lokal XAMPP belum mengaktifkan fitur SSI untuk file berformat SHTML, sehingga ketika diakses melalui browser, file tersebut akan menampilkan teks mentah atau memicu unduhan alih-alih mengeksekusi perintah penyertaan modul dokumen.
Pengembang web sering kali membutuhkan file SHTML untuk menggabungkan bagian situs web yang berulang—seperti header, footer, dan sidebar—tanpa harus menulis ulang kode HTML yang sama di setiap halaman. Dengan konfigurasi Apache yang tepat di XAMPP, environment lokal Anda akan meniru perilaku server produksi secara akurat, memastikan fungsi SSI berjalan mulus sebelum diunggah ke hosting server langsung.
Persiapan Alat dan Akses File Konfigurasi Apache
Langkah awal yang wajib Anda lakukan adalah memastikan aplikasi XAMPP telah terpasang dengan baik pada sistem operasi komputer Anda, baik di lingkungan Windows maupun sistem lainnya. Buka panel kontrol XAMPP, pastikan modul Apache berada dalam kondisi berhenti atau tidak sedang berjalan untuk menghindari konflik modifikasi file saat proses penyuntingan teks konfigurasi.
Arahkan penjelajah file komputer Anda ke direktori instalasi XAMPP, biasanya berada di C:\xampp\apache\conf\. Di dalam folder tersebut, cari file bernama httpd.conf yang berfungsi sebagai pusat pengaturan utama server Apache. Buka file tersebut menggunakan teks editor tingkat lanjut seperti Notepad++, Visual Studio Code, atau Sublime Text untuk memudahkan pencarian baris kode spesifik yang perlu diubah.
Langkah-Langkah Teknis Mengaktifkan Modul SSI
Di dalam file httpd.conf, gunakan fitur pencarian (Ctrl + F) untuk menemukan baris kode modul mod_include.so. Hapus tanda pagar atau simbol tanda seru di awal baris kode LoadModule include_module modules/mod_include.so jika baris tersebut sebelumnya dinonaktifkan oleh sistem. Keberadaan tanda pagar menandakan baris tersebut dianggap sebagai komentar dan diabaikan oleh server Apache saat proses inisialisasi modul.
Selanjutnya, cari blok pengaturan direktori utama server Anda, yang biasanya diawali dengan tag <Directory "C:/xampp/htdocs"> atau direktori kustom tempat Anda menyimpan proyek web lokal. Di dalam blok direktori tersebut, cari bagian parameter Options yang umumnya berisi nilai seperti Indexes FollowSymLinks, lalu tambahkan kata Includes di samping parameter yang sudah ada sebelumnya.
Menambahkan Handler dan Filter Ekstensi SHTML
Langkah krusial berikutnya adalah mendefinisikan bagaimana server Apache mengenali dan memproses file dengan ekstensi .shtml. Cari baris teks AddType text/html .shtml di dalam file httpd.conf, pastikan baris tersebut aktif atau tambahkan secara manual jika belum tersedia pada lembar konfigurasi Anda.
Di bawah baris pengendali tipe tersebut, tambahkan pula baris perintah AddOutputFilter INCLUDES .shtml agar server secara otomatis menerapkan filter pemrosesan SSI pada setiap file berformat .shtml yang dimuat. Perintah ini menginstruksikan Apache untuk memindai tag khusus seperti <!--#include virtual="header.html" --> dan menggantinya dengan konten asli sebelum dikirimkan ke peramban pengguna.
Tabel Ringkasan Parameter Konfigurasi Apache XAMPP
| Parameter Konfigurasi | Status Default | Nilai Ubahan yang Dibutuhkan | Fungsi Utama |
|---|---|---|---|
| LoadModule include_module | Nonaktif / Komentar | Aktifkan (Hapus Tanda #) | Memuat modul SSI Apache |
| Directory Options | Indexes FollowSymLinks | Indexes FollowSymLinks Includes | Memberi izin eksekusi SSI di folder |
| AddType text/html .shtml | Mungkin Nonaktif | Aktifkan / Tambahkan Baris | Menetapkan tipe media file .shtml |
| AddOutputFilter INCLUDES | Tidak Ada | AddOutputFilter INCLUDES .shtml | Mengaktifkan filter parser server |
Uji Coba File SHTML dan Penanganan Masalah Lapangan
Simpan perubahan file httpd.conf yang telah Anda lakukan, lalu kembali ke panel kontrol XAMPP dan jalankan kembali modul Apache dengan menekan tombol Start. Buat file baru berpenamaan index.shtml di dalam folder htdocs, lalu isi dengan sintaks dasar SSI seperti <!--#echo var="DATE_LOCAL" --> untuk menguji apakah server berhasil mem-parse perintah tersebut.
Jika halaman web tetap menampilkan teks kode secara mentah alih-alih mengeksekusi fungsi waktu atau penyertaan file, periksa kembali apakah ekstensi file Anda benar-benar .shtml dan bukan .shtml.txt akibat pengaturan sistem operasi yang menyembunyikan ekstensi file asli. Pastikan pula Anda mengakses file melalui protokol lokal http://localhost/ alih-alih membuka file secara langsung dari direktori lokal komputer.