Cara Include File HTML di XAMPP: Panduan Integrasi PHP & Session

Menggabungkan atau menyertakan (include) file HTML di dalam proyek PHP pada server lokal XAMPP dapat dilakukan menggunakan fungsi bawaan PHP seperti include, require, include_once, atau require_once. Karena server web Apache pada XAMPP memproses file berdasarkan ekstensi, fungsi ini memungkinkan pengembang untuk memecah komponen halaman web—seperti header, footer, atau sidebar—menjadi file terpisah guna efisiensi penulisan kode.

Berdasarkan dokumentasi teknis pengembangan web lokal menggunakan XAMPP dan manajemen sesi (session), pengelolaan file dan direktori pada folder htdocs membutuhkan struktur direktori yang tepat agar path file yang dipanggil dapat terbaca dengan sempurna oleh server tanpa mengalami error 404 Not Found atau failed to open stream.

Persiapan Lingkungan Kerja di XAMPP

Sebelum melakukan teknik include file HTML atau PHP, pastikan layanan Apache pada Control Panel XAMPP sudah dalam kondisi aktif (Running). Letakkan seluruh berkas proyek Anda di dalam direktori instalasi XAMPP, tepatnya pada folder C:\xampp\htdocs\nama-proyek\.

Tabel Perintah Include di PHP

Fungsi PHP Keterangan Perilaku Penanganan Error
include Menyertakan file pada baris eksekusi. Menampilkan pesan peringatan (Warning), skrip tetap lanjut.
require Menyertakan file pada baris eksekusi. Menampilkan pesan fatal (Fatal Error), ekskusi skrip berhenti.
include_once Menyertakan file 1 kali, mencegah duplikasi fungsi/variabel. Menampilkan pesan peringatan (Warning), skrip tetap lanjut.
require_once Menyertakan file 1 kali, mencegah duplikasi mutlak. Menampilkan pesan fatal (Fatal Error), ekskusi skrip berhenti.

Implementasi Kode Include File

Untuk menyertakan file HTML murni atau file dengan ekstensi .php yang berisi markup HTML ke dalam halaman utama, gunakan sintaks berikut di dalam dokumen PHP Anda:

<?php
// Memanggil file header.html atau header.php
include 'header.php';
?>

<div class="content">
    <h1>Selamat Datang di Server Lokal XAMPP</h1>
    <p>Konten halaman utama website Anda berada di sini.</p>
</div>

<?php
// Memanggil file footer.php
include 'footer.php';
?>

Langkah-Langkah Teknis Pengujian

  1. Buka aplikasi XAMPP Control Panel dan klik tombol Start pada modul Apache.
  2. Buat folder baru dengan nama tutorial di dalam direktori C:\xampp\htdocs\.
  3. Buat file bernama index.php dan file komponen pendukung seperti header.php di dalam folder tersebut.
  4. Buka peramban web (browser) lalu ketikkan alamat http://localhost/tutorial/index.php untuk melihat hasil eksekusi server lokal.

Troubleshooting Masalah Umum

Jika file yang di-include tidak tampil atau memunculkan error, periksa beberapa hal berikut:

  • Path Direktori Salah: Pastikan relatif path atau absolute path yang dituliskan di dalam parameter include sudah sesuai dengan posisi folder fisik berkas.
  • Ekstensi File: Jika file yang dipanggil berisi kode PHP (seperti fungsi session atau logika pemrograman), pastikan ekstensi file tersebut adalah .php, bukan murni .html, karena server Apache secara default tidak memproses kode PHP di dalam file ber-ekstensi .html kecuali dikonfigurasi melalui file .htaccess.
  • Apache Belum Aktif: Pastikan modul Apache berwarna hijau bertuliskan 'Running' pada XAMPP Control Panel.