💡 ULASAN & REFERENSI • DIPERBARUI: 21 October 2026 • REDAKSI AZWINN

Konfigurasi SSI Apache cPanel: Panduan Lengkap .shtml

Server Side Includes (SSI) adalah bahasa skrip sederhana yang digunakan untuk menyertakan file luar ke dalam halaman web dan menjalankan fungsi dinamis dasar pada server web Apache. Di cPanel, konfigurasi SSI umumnya dilakukan dengan mengaktifkan handler ekstensi file .shtml atau menambahkan direktif khusus pada file .htaccess agar server Apache mengenali dan memproses sintaks SSI di dalam file HTML.

Untuk menjalankan SSI, Anda memerlukan akses ke cPanel hosting Anda, khususnya menu Apache Handlers atau pengelolaan file melalui File Manager. Berikut adalah tabel ringkasan metode utama konfigurasi SSI pada server Apache berbasis cPanel:

Metode Konfigurasi Target File Tingkat Kesulitan Fungsi Utama
Apache Handlers cPanel cPanel UI / File Manager Mudah Menambahkan handler server untuk ekstensi file tertentu.
File .htaccess Root Direktori Public_html Menengah Mengaktifkan parsing SSI secara global atau per folder.
Directives httpd.conf WHM / Root Server Lanjutan Konfigurasi tingkat server (membutuhkan akses root VPS/Dedicated).

Langkah 1: Mengaktifkan SSI Melalui File .htaccess

Cara paling cepat dan umum digunakan untuk mengaktifkan SSI pada akun cPanel shared hosting adalah dengan menyisipkan baris kode ke dalam file .htaccess di direktori public_html situs Anda.

AddType text/html .shtml
AddHandler server-parsed .shtml
Options +Includes

Jika Anda ingin memperbolehkan file dengan ekstensi standar .html atau .php untuk memproses SSI (meskipun kurang disarankan karena alasan performa server), Anda dapat memodifikasi baris handler menjadi:

AddHandler server-parsed .html .shtml
Options +Includes

Langkah 2: Verifikasi Lewat Apache Handlers di cPanel

Jika hosting Anda tidak mengizinkan modifikasi Options +Includes melalui .htaccess (biasanya memunculkan error 500 Internal Server Error), Anda harus menggunakan fitur bawaan cPanel:

  1. Login ke akun cPanel Anda.
  2. Gulir ke bagian Advanced dan klik menu Apache Handlers.
  3. Pada bagian Add Handler, masukkan nilai berikut:
    • Handler: server-parsed
    • Extension(s): shtml
  4. Klik tombol Add.

Langkah 3: Membuat dan Menguji File SSI

Setelah konfigurasi server selesai, buat file baru menggunakan File Manager di cPanel atau teks editor lokal Anda dengan nama index.shtml. Masukkan kode uji coba SSI berikut untuk memastikan modul bekerja dengan baik:

<!--#echo var="DATE_LOCAL" -->
<!--#include virtual="footer.html" -->

Unggah file tersebut ke direktori public_html dan akses melalui browser. Jika tanggal server muncul dan file footer berhasil disisipkan tanpa error, konfigurasi SSI Apache di cPanel Anda telah sukses.

Troubleshooting Masalah Umum SSI

Kendala yang sering ditemui saat konfigurasi SSI adalah munculnya error 500 atau teks kode SSI muncul mentah di browser tanpa dieksekusi. Hal ini biasanya disebabkan oleh:

  • Options Not Allowed: Server menolak direktif Options +Includes di .htaccess. Solusinya, hapus baris Options +Includes dan biarkan bagian AddHandler saja jika server sudah mengaturnya secara global.
  • Ekstensi Salah: Pastikan file Anda menggunakan ekstensi .shtml kecuali Anda telah menambahkan handler untuk ekstensi .html.

🔍 Orang Lain Juga Mencari Ini