Fungsi Nginx SSI Echo
Direktif ssi echo pada Nginx digunakan untuk mencetak nilai variabel ke dalam output HTML sebelum halaman dikirimkan ke klien. Fitur ini merupakan bagian dari modul ngx_http_ssi_module yang memungkinkan pemrosesan Server Side Includes (SSI). Penggunaan utama direktif ini adalah untuk menampilkan informasi dinamis seperti alamat IP pengunjung, nama host, atau variabel lingkungan server tanpa memerlukan bahasa pemrograman backend seperti PHP atau Python.
Sintaks Dasar
Untuk menggunakan echo dalam file SSI, Anda harus menyertakan sintaks berikut di dalam file HTML Anda:
<!--# echo var="NAMA_VARIABEL" -->Pastikan direktif ssi on; telah diaktifkan di dalam blok http, server, atau location pada konfigurasi Nginx Anda agar pemrosesan SSI berjalan.
Tabel Variabel Umum Nginx
| Variabel | Deskripsi |
|---|---|
| remote_addr | Alamat IP klien |
| http_user_agent | Informasi browser/user agent klien |
| request_uri | URI permintaan lengkap |
| host | Nama host dari baris permintaan |
| date_local | Tanggal dan waktu lokal server |
Langkah Implementasi
- Aktifkan Modul SSI: Tambahkan
ssi on;di dalam blok konfigurasi Nginx Anda. - Konfigurasi Variabel: Jika Anda ingin menampilkan variabel kustom, gunakan
setdi Nginx:set $my_var "Halo Dunia";. - Panggil di HTML: Gunakan tag
<!--# echo var="my_var" -->di dalam file HTML. - Reload Nginx: Jalankan perintah
nginx -s reloaduntuk menerapkan perubahan.
Troubleshooting
Jika variabel tidak muncul, periksa hal berikut: 1) Apakah ssi on; sudah aktif? 2) Apakah file memiliki ekstensi yang diproses oleh Nginx? 3) Apakah variabel tersebut memang tersedia dalam konteks request saat ini? Gunakan parameter default jika variabel mungkin kosong: <!--# echo var="var_kosong" default="Nilai Default" -->.