Cara Test File SHTML di Localhost: Panduan Server Lokal

Pengantar Pengujian File SHTML di Localhost

Untuk menguji file berformat .shtml (Server Side Includes) di komputer lokal (localhost), Anda memerlukan web server seperti Apache yang mendukung dan mengaktifkan modul mod_include. File SHTML tidak dapat berjalan langsung hanya dengan membuka file dari direktori lokal melalui protokol file:/// di browser, melainkan harus melalui protokol HTTP dari server lokal.

Persiapan Lingkungan Server Lokal

Sebelum menjalankan file SHTML, pastikan Anda telah memasang paket server lokal seperti XAMPP, WAMP, atau mengonfigurasi Apache secara manual. Langkah krusial pertama adalah memastikan bahwa modul untuk Server Side Includes diaktifkan pada konfigurasi server Apache Anda (httpd.conf).

Tabel Konfigurasi Modul Apache untuk SHTML

Komponen Konfigurasi Parameter Nilai Fungsi dalam Eksekusi SHTML
Modul Apache LoadModule include_module modules/mod_include.so Mengaktifkan modul pemrosesan Server Side Includes di Apache.
Handler Eksekusi AddType text/html .shtml
AddOutputFilter INCLUDES .shtml
Memberitahu server untuk memproses file ber-ekstensi .shtml sebagai dokumen HTML yang berisi instruksi SSI.
Direktif Options Options +Includes Memberikan izin direktori untuk mengeksekusi instruksi SSI di dalam folder proyek.

Langkah-Langkah Membuat dan Menguji File SHTML

Ikuti prosedur teknis di bawah ini untuk membuat file uji coba SHTML dan menjalankannya di lingkungan localhost Anda:

  1. Buka Direktori Root Server: Masuk ke folder penyimpanan web server Anda. Jika menggunakan XAMPP di Windows, direktori utamanya berada di C:\xampp\htdocs\.
  2. Buat Folder Proyek Baru: Buat folder dengan nama bebas di dalam htdocs, misalnya test-shtml.
  3. Buat File Kode SHTML: Buat file teks baru di dalam folder tersebut dan beri nama index.shtml.
  4. Masukkan Sintaks SSI: Gunakan kode dasar di bawah ini untuk menguji apakah instruksi Server Side Includes terbaca oleh server.

Contoh Kode Uji Coba (index.shtml)

<!DOCTYPE html>
<html lang="id">
<head>
    <meta charset="UTF-8">
    <title>Test SHTML Localhost</title>
</head>
<body>
    <h1>Pengujian Server Side Includes (SSI)</h1>
    <p>Waktu server saat ini: <!--#echo var="DATE_LOCAL" --></p>
    <p>Nama file dokumen ini: <!--#echo var="DOCUMENT_NAME" --></p>
    
    <!-- Contoh menyertakan file eksternal (header/footer) -->
    <!--#include virtual="footer.html" -->
</body>
</html>
  1. Nyalakan Web Server: Buka panel kontrol XAMPP atau layanan Apache Anda, lalu klik Start pada modul Apache.
  2. Akses melalui Browser: Buka browser web Anda (Chrome, Firefox, Edge, dll.) dan ketikkan alamat URL berikut di bilah alamat: http://localhost/test-shtml/index.shtml

Troubleshooting Masalah Umum

Jika halaman yang diakses hanya menampilkan teks tag SSI secara mentah (misalnya tertulis <!--#echo var="DATE_LOCAL" --> tanpa mengeksekusi nilainya), atau halaman memunculkan error 500 Internal Server Error, periksa beberapa hal berikut:

  • Akses Protokol: Pastikan Anda mengaksesnya menggunakan awalan http://localhost/, bukan dengan membuka file langsung dari Windows Explorer (file:///C:/...). Apache harus memproses file tersebut agar sintaks SHTML dikenali.
  • Izin Direktori: Pastikan konfigurasi blok direktori di file httpd.conf atau httpd-vhosts.conf memiliki opsi Includes (contoh: Options Indexes FollowSymLinks Includes).
  • Log Kesalahan: Periksa berkas error.log pada direktori server Apache Anda untuk melihat detail spesifik penyebab kegagalan eksekusi modul.