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
- Buka aplikasi XAMPP Control Panel dan klik tombol Start pada modul Apache.
- Buat folder baru dengan nama
tutorialdi dalam direktoriC:\xampp\htdocs\. - Buat file bernama
index.phpdan file komponen pendukung sepertiheader.phpdi dalam folder tersebut. - Buka peramban web (browser) lalu ketikkan alamat
http://localhost/tutorial/index.phpuntuk 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
includesudah 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.htmlkecuali dikonfigurasi melalui file.htaccess. - Apache Belum Aktif: Pastikan modul Apache berwarna hijau bertuliskan 'Running' pada XAMPP Control Panel.