Menjalankan file berformat .shtml memerlukan server web yang mendukung dan telah mengaktifkan modul Server Side Includes (SSI). Berbeda dengan file HTML biasa yang dapat langsung dibuka melalui browser secara lokal (menggunakan protokol file://), file SHTML memuat arahan khusus bagi server untuk memproses teks sebelum dikirim ke peramban pengguna, seperti menyertakan file navigasi atau header secara dinamis.
Untuk menjalankan file SHTML dengan sukses, Anda harus memastikan bahwa server web lokal seperti Apache atau Nginx dikonfigurasi untuk mengenali ekstensi tersebut dan mengeksekusi perintah SSI di dalamnya.
Persyaratan Sistem dan Konfigurasi Server
Agar server web dapat memproses sintaks SSI (diawali dengan tag <!--#), modul terkait harus diaktifkan pada konfigurasi server utama atau melalui berkas .htaccess pada hosting berbasis Apache.
| Web Server | Modul / Fitur yang Dibutuhkan | File Konfigurasi Utama | Perintah Aktivasi SSI |
|---|---|---|---|
| Apache | mod_include | httpd.conf / .htaccess | AddHandler server-parsed .shtmlOptions +Includes |
| Nginx | ngx_http_ssi_module | nginx.conf | ssi on;ssi_types text/html shtml; |
| XAMPP / Local | mod_include (Apache) | httpd.conf | Pastikan baris LoadModule include_module ... tidak dikomentari. |
Contoh Kode SHTML dengan SSI
Berikut adalah contoh struktur dasar file SHTML yang menggunakan perintah #include untuk memuat file eksternal seperti navigasi atau footer secara modular:
<!DOCTYPE html>
<html lang="id">
<head>
<meta charset="UTF-8">
<title>Halaman SHTML Saya< /title>
</head>
<body>
<!-- Menyertakan file header secara dinamis -->
<!--#include virtual="header.html" -->
<main>
<h1>Selamat Datang di Website SHTML</h1>
<p>Halaman ini diproses menggunakan Server Side Includes.</p>
<p>Waktu server saat ini: <!--#echo var="DATE_LOCAL" --></p>
</main>
<!-- Menyertakan file footer secara dinamis -->
<!--#include virtual="footer.html" -->
</body>
</html>
Langkah-Langkah Menjalankan SHTML di Server Lokal (XAMPP)
- Buka panel kontrol XAMPP dan aktifkan modul Apache.
- Buka direktori instalasi XAMPP, biasanya berada di
C:\xampp\htdocs\. - Buat folder baru di dalam
htdocs, misalnya beri namaproyek-shtml. - Pastikan server Apache mengizinkan parsing SSI. Buka file konfigurasi
httpd.conf(melalui tombol Config di XAMPP), cari barisAddHandler server-parsed .shtmldan pastikan aktif. - Buat file dengan nama
index.shtmldi dalam folder proyek Anda dan masukkan kode contoh di atas. - Buka browser web Anda dan akses melalui alamat:
http://localhost/proyek-shtml/index.shtml. Jangan membuka file langsung dari penyimpanan lokal (klik dua kali), karena server tidak akan memproses perintah SSI.
Troubleshooting Masalah Umum SHTML
Jika halaman SHTML Anda menampilkan teks mentah berupa kode tag SSI (seperti <!--#include ... -->) atau mengalami error 500 Internal Server Error, periksa beberapa hal berikut:
- Akses via HTTP: Pastikan Anda mengakses file melalui server lokal (localhost) atau web hosting, bukan membuka file mentah langsung dari harddisk komputer.
- Konfigurasi Server: Pada server Apache, pastikan direktif
Options +Includestelah disetel pada konfigurasi direktori atau file.htaccess. - Sintaks Tag: Perhatikan spasi di dalam tag SSI. Penulisan yang benar harus memiliki spasi persis setelah tanda buka
<!--#dan sebelum tanda tutup-->.