Cara Edit File Server Side Includes (SSI) di Server Web

Cara edit file Server Side Includes (SSI) dilakukan dengan membuka file berformat khusus seperti .shtml menggunakan teks editor, lalu mengubah direktif SSI yang disematkan di dalam komentar HTML seperti <!--#include virtual="header.html" -->. SSI memungkinkan penyisipan konten modular ke dalam beberapa halaman web tanpa harus menyunting setiap file satu per satu.

Untuk melakukan penyuntingan file SSI secara efektif dan menghindari kesalahan rendering pada server web, ikuti langkah-langkah teknis, tabel metode akses, serta panduan konfigurasi yang teruji di bawah ini.

Metode Akses dan Pengeditan File SSI

Terdapat tiga metode utama yang biasa digunakan oleh pengembang web dan administrator sistem untuk menyunting file SSI, bergantung pada lingkungan kerja dan akses server yang tersedia.

Langkah-Langkah Teknis Mengedit File SSI

Berikut adalah prosedur standar untuk mengedit file SSI langsung melalui lingkungan server atau menggunakan teks editor berbasis teks.

1. Akses Direktori Root Website: Masuk ke direktori publik web Anda (biasanya public_html atau www) tempat file dengan ekstensi .shtml berada.
2. Buka File dengan Editor: Gunakan teks editor yang mendukung sintaks HTML dan komentar (seperti VS Code, Notepad++, atau Nano di terminal). Hindari menggunakan Microsoft Word untuk mencegah karakter tersembunyi yang merusak kode.
3. Ubah Direktif SSI: Edit baris kode SSI sesuai kebutuhan. Contoh sintaks penyisipan file:

   <!--#include virtual="/includes/header.html" -->

4. Simpan dan Unggah: Simpan file dengan mempertahankan ekstensi .shtml (bukan .html biasa, kecuali server dikonfigurasi untuk memproses SSI pada ekstensi .html).
5. Uji Coba di Browser: Muat ulang halaman web melalui browser untuk memastikan direktif SSI dieksekusi dengan benar oleh server dan tidak memunculkan pesan kesalahan (error 500).

Konfigurasi Server untuk Mendukung SSI

Jika perubahan pada file SSI tidak dirender oleh server (hanya menampilkan teks komentar mentah), pastikan modul SSI pada server web Anda telah diaktifkan.

Konfigurasi pada Apache (.htaccess atau httpd.conf)

Tambahkan baris berikut ke dalam file .htaccess di direktori root situs Anda agar server Apache mengizinkan eksekusi SSI pada file berformat .shtml:

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

Konfigurasi pada Nginx (nginx.conf)

Nginx tidak mendukung SSI secara default untuk semua blok server. Tambahkan direktif ssi on; di dalam blok server atau location:

location / {
    ssi on;
    ssi_types text/html;
}

Troubleshooting Masalah SSI di Lapangan

Beberapa kendala umum yang sering terjadi saat mengedit file SSI meliputi:

• Muncul Pesan [an error occurred while processing this directive]: Kesalahan ini biasanya terjadi karena jalur file (path) pada atribut virtual atau file salah, atau file yang ingin disisipkan tidak ditemukan di direktori tersebut. Gunakan path absolut berbasis root web (diawali dengan garis miring /) untuk menghindari kesalahan direktori relatif.
• File .html Biasa Tidak Memproses SSI: Secara default, performa server dioptimalkan untuk hanya memindai file dengan ekstensi .shtml. Ubah konfigurasi handler server jika Anda ingin file .html juga memproses SSI, meski hal ini dapat sedikit membebani penggunaan CPU server.