Menjalankan file berformat .shtml (Server Side Includes) secara lokal memerlukan web server yang aktif karena file ini memproses perintah sisi server sebelum dikirim ke peramban. Berbeda dengan file HTML biasa yang bisa langsung dibuka dengan mengklik dua kali, file SHTML akan menampilkan kesalahan atau teks mentah jika dibuka langsung dari direktori lokal tanpa server HTTP.
Berdasarkan data referensi terkait pemanfaatan ekstensi server dan integrasi dokumen web, pengelolaan file berbasis server seperti SHTML sering kali dijumpai pada sistem manajemen konten atau dokumentasi teknis yang memerlukan pemanggilan data modular (seperti perintah #include). Berikut adalah panduan teknis untuk menjalankan file SHTML di komputer lokal Anda.
Metode 1: Menggunakan Local Web Server (XAMPP / Apache)
Cara paling akurat dan sesuai dengan standar produksi adalah menggunakan server web lokal seperti Apache yang disertakan dalam paket XAMPP.
- Unduh dan instal aplikasi XAMPP dari laman resminya.
- Buka XAMPP Control Panel dan klik tombol Start pada modul Apache.
- Arahkan direktori penyimpanan file SHTML Anda ke dalam folder root server, yaitu di
C:\xampp\htdocs\(buat folder baru di dalamnya, misalnyaproyek-shtml). - Pastikan konfigurasi server Apache mengizinkan parsing SSI. Periksa file
httpd.confdan pastikan modulinclude_moduleaktif serta direktori proyek memiliki opsiIncludes. - Buka peramban web (browser) dan ketikkan alamat
http://localhost/proyek-shtml/namafile.shtml.
Perbandingan Metode Menjalankan File SHTML
| Metode | Kelebihan | Kekurangan |
|---|---|---|
| Local Web Server (Apache/XAMPP) | Mendukung penuh fungsi SSI, akurat seperti server produksi. | Memerlukan instalasi software tambahan dan konfigurasi awal. |
| Node.js Local Server | Ringan, cepat, cocok untuk pengembang modern. | Memerlukan modul tambahan untuk parsing SSI secara spesifik. |
| Ekstensi Browser | Praktis tanpa instalasi server berat. | Fitur SSI sering kali tidak berjalan sempurna karena keterbatasan sandboxing browser. |
Langkah Troubleshooting Jika SHTML Tidak Berjalan
Jika file SHTML Anda hanya menampilkan teks kode mentah atau error 500, periksa beberapa hal berikut:
- Periksa URL: Pastikan Anda mengaksesnya melalui protokol
http://localhost/..., bukan menggunakan path file lokal sepertifile:///C:/.... - Konfigurasi Server: Pastikan ekstensi
.shtmldipetakan dengan benar ke handler server di konfigurasi Apache (AddHandler server-parsed .shtml). - Sintaks SSI: Periksa kembali penulisan tag SSI di dalam file, misalnya
<!--#include virtual="header.html" -->, pastikan tidak ada kesalahan spasi atau tanda kutip.