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

Cara Mengaktifkan Mod Include Apache di cPanel

Modul mod_include Apache adalah filter yang mengimplementasikan Server Side Includes (SSI), sebuah mekanisme untuk menyisipkan teks, file, atau output dari program CGI ke dalam halaman web secara dinamis. Di lingkungan cPanel, modul ini umumnya sudah aktif secara default di tingkat server global, namun terkadang membutuhkan konfigurasi tambahan atau penanganan MIME types agar file HTML (.html atau .shtml) dapat memproses perintah SSI seperti <!--#include virtual="header.html" -->.

Untuk mengaktifkan dan mengonfigurasi pemrosesan SSI pada akun hosting cPanel, Anda tidak perlu mengakses konfigurasi Apache utama (httpd.conf) karena hal tersebut dikelola oleh administrator server (root). Sebagai pemilik akun cPanel, tugas Anda adalah memastikan handler tipe MIME terdaftar dengan benar di file .htaccess atau melalui menu Apache Handlers di cPanel agar server mengenali ekstensi file yang akan menjalankan perintah include.

Langkah-Langkah Konfigurasi SSI di cPanel

Berikut adalah tahapan teknis yang harus dilakukan untuk mengaktifkan dan menggunakan mod_include pada direktori web Anda:

  1. Login ke cPanel: Masuk ke panel hosting Anda menggunakan kredensial yang valid.
  2. Buka Menu Apache Handlers: Cari bagian Advanced atau gunakan kolom pencarian, lalu klik ikon Apache Handlers.
  3. Tambahkan Handler Baru: Pada bagian Add, masukkan data berikut untuk mendaftarkan handler server-parsed:
    • Handler: server-parsed
    • Extension(s): shtml (atau html jika Anda ingin file .html biasa memproses SSI, meski kurang disarankan untuk performa).
  4. Simpan Pengaturan: Klik tombol Add.

Tabel Perbandingan Ekstensi File untuk SSI

Ekstensi File Handler Apache Kelebihan Kekurangan
.shtml server-parsed Aman, tidak membebani parsing file HTML murni. Membutuhkan perubahan ekstensi pada tautan file yang sudah ada.
.html / .htm server-parsed Tidak perlu mengubah tautan URL yang sudah terindeks. Apache akan memindai seluruh file HTML untuk mencari tag SSI, menurunkan performa server secara keseluruhan.

Penerapan Kode SSI (.htaccess dan File HTML)

Jika Anda tidak ingin menggunakan menu Apache Handlers secara manual, Anda bisa menambahkan baris kode konfigurasi langsung ke dalam file .htaccess yang berada di direktori root web Anda (public_html). Pastikan file tersebut mencakup baris berikut:

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

Setelah konfigurasi selesai, buat file baru bernama index.shtml di dalam public_html dan masukkan contoh sintaks SSI berikut untuk menguji apakah modul berfungsi:

<html>
<head>
    <title>Tes Mod Include</title>
</head>
<body>
    <h1>Halaman Utama</h1>
    <!--#include virtual="/footer.html" -->
</body>
</html>

Troubleshooting Masalah Umum SSI

Jika perintah include tidak berjalan dan halaman menampilkan pesan kesalahan atau teks tag mentah (tidak dieksekusi), periksa beberapa hal berikut:

  • Error 500 Internal Server Error: Biasanya disebabkan oleh direktif Options +Includes yang diblokir oleh konfigurasi keamanan server utama (AllowOverride). Hubungi penyedia hosting Anda untuk memastikan modul mod_include diizinkan di tingkat direktori.
  • File Tidak Ditemukan: Pastikan jalur (path) pada atribut virtual atau file sudah benar. Atribut virtual menggunakan path relatif terhadap dokumen root, sedangkan file menggunakan path relatif terhadap direktori file yang sedang aktif.

🔍 Orang Lain Juga Mencari Ini