Ketahui Perbedaan Include Dan Require Di PHP Agar Tidak Bingung
Saat belajar PHP, kamu akan sering memisahkan kode ke beberapa file, seperti koneksi database, kumpulan fungsi, dan tampilan halaman. Untuk memanggil file-file tersebut, PHP menyediakan dua perintah yang sering digunakan, yaitu include dan require. Sekilas, keduanya terlihat sama karena sama-sama berfungsi memasukkan isi file ke dalam script yang sedang dijalankan.
Namun, ada satu perbedaan penting yang perlu kamu pahami, terutama ketika file yang dipanggil tidak ditemukan. Include memungkinkan script tetap berjalan meskipun file gagal dimuat, sedangkan require akan menghentikan eksekusi program. Memahami perbedaan include dan require di PHP akan membantumu menentukan perintah yang tepat dan menghindari kesalahan saat mengembangkan aplikasi.
Perbedaan Include dan Require di PHP Saat File Tidak Ditemukan

Perbedaan paling mendasar antara include dan require terlihat ketika PHP tidak berhasil menemukan file yang dipanggil. Misalnya, kamu memasukkan file konfigurasi database, tetapi nama file salah atau lokasinya sudah berubah.
Jika menggunakan include, PHP akan mengeluarkan peringatan (warning), tetapi script tetap melanjutkan proses ke baris berikutnya. Sebaliknya, require akan menghasilkan error yang menghentikan eksekusi script sehingga kode setelahnya tidak dijalankan.
Berikut perbandingan perilaku keempat perintah tersebut:
|
Pernyataan |
Jika File Tidak Ditemukan |
Eksekusi Script |
|---|---|---|
|
include |
Warning |
Tetap berjalan |
|
require |
Error |
Berhenti |
|
include_once |
Warning |
Tetap berjalan |
|
require_once |
Error |
Berhenti |
Perbedaan ini bukan sekadar masalah penulisan kode, melainkan berkaitan dengan seberapa penting file yang dipanggil bagi aplikasi. Jika sebuah file wajib tersedia agar halaman berfungsi, gunakan require. Namun, jika file tersebut hanya berisi komponen tambahan yang boleh tidak dimuat, include bisa menjadi pilihan.
Kapan Sebaiknya Menggunakan Require?
Gunakan require untuk memanggil file yang keberadaannya wajib agar aplikasi dapat berjalan dengan benar. Contohnya adalah konfigurasi database, file autentikasi, kumpulan fungsi utama, dan definisi kelas yang dibutuhkan oleh halaman.
Bayangkan kamu sedang membuat halaman yang menampilkan data pengguna dari database. Jika file koneksi database gagal dimuat, proses selanjutnya tidak mungkin berjalan sebagaimana mestinya. Karena itu, lebih baik menghentikan script daripada membiarkannya berjalan tanpa koneksi yang diperlukan.
Contoh Penggunaan Require
Berikut contoh penggunaan require untuk memanggil file konfigurasi dan fungsi utama:
<?php
require ‘config/database.php’;
require ‘lib/functions.php’;
?>
Jika salah satu file tersebut tidak ditemukan, PHP akan menghentikan eksekusi dan menampilkan error. Dengan begitu, kamu bisa langsung mengetahui bahwa ada file penting yang bermasalah.
Kapan Sebaiknya Menggunakan Include?
Berbeda dengan require, include lebih cocok untuk memanggil file tambahan yang tidak menentukan fungsi utama aplikasi. Misalnya, sidebar, banner promosi, widget, atau komponen tampilan lainnya.
Jika salah satu komponen tersebut gagal dimuat, halaman utama masih bisa berfungsi meskipun tampilannya tidak lengkap. Dalam kondisi seperti ini, penggunaan include membuat aplikasi tetap bisa menampilkan bagian yang tidak bermasalah.
Contoh Penggunaan Include
Contoh berikut menunjukkan penggunaan include untuk memanggil komponen tampilan:
<?php
include ‘partials/sidebar.php’;
include ‘partials/promo-banner.php’;
?>
Jika file sidebar tidak ditemukan, PHP akan mengeluarkan warning, tetapi tetap melanjutkan proses. Halaman masih bisa ditampilkan tanpa komponen sidebar tersebut.
Meski begitu, jangan menggunakan include untuk file penting hanya agar script tetap berjalan. Cara tersebut justru bisa menyembunyikan masalah dan menyebabkan aplikasi menampilkan data yang tidak lengkap atau mengalami error di bagian lain.
Apa Perbedaan Include_once dan Require_once?
Selain include dan require, PHP juga menyediakan include_once dan require_once. Keduanya memiliki fungsi dasar yang sama dengan perintah biasa, tetapi dilengkapi mekanisme untuk mencegah file yang sama dimuat lebih dari satu kali dalam satu eksekusi script.
Fitur ini berguna ketika sebuah file dipanggil dari beberapa bagian aplikasi. Misalnya, file utama memanggil kumpulan fungsi, sementara file header yang digunakan oleh halaman tersebut juga memanggil file yang sama.
Tanpa tambahan _once, PHP bisa memproses file tersebut berulang kali. Jika file berisi deklarasi fungsi atau kelas, pemanggilan berulang dapat menimbulkan error karena deklarasi yang sama dibuat lebih dari sekali.
Contoh Penggunaan Require_once
Berikut contoh penggunaan require_once untuk memastikan file fungsi hanya dimuat satu kali:
<?php
require_once ‘lib/functions.php’;
require_once ‘lib/functions.php’;
?>
Pada contoh tersebut, PHP hanya memuat file functions.php satu kali. Pemanggilan kedua akan diabaikan karena file tersebut sudah pernah dimuat.
Aturan penggunaannya cukup sederhana:
- include_once digunakan untuk memanggil file tambahan yang tidak wajib tersedia.
- require_once digunakan untuk memanggil file penting yang wajib tersedia dan tidak boleh dimuat berulang kali.
Dengan demikian, tambahan _once tidak mengubah cara PHP menangani kegagalan pemanggilan file. Perbedaannya tetap sama: include_once memberikan warning, sedangkan require_once menghentikan eksekusi jika file tidak ditemukan.
Kesalahan yang Sering Terjadi Saat Menggunakan Include dan Require
Memahami perbedaan include dan require di PHP belum cukup jika kamu masih melakukan kesalahan dalam penerapannya. Beberapa masalah berikut cukup sering terjadi, terutama ketika proyek mulai memiliki banyak file dan folder.
1. Salah Menentukan Lokasi File
Kesalahan path merupakan salah satu penyebab file gagal dimuat. PHP mencari file berdasarkan aturan pencarian yang melibatkan include_path, direktori script yang sedang dijalankan, dan direktori kerja saat ini.
Untuk menghindari kebingungan akibat path relatif, kamu bisa menggunakan konstanta __DIR__ yang menunjukkan lokasi direktori file PHP tempat konstanta tersebut ditulis.
Contohnya:
<?php
require __DIR__ . ‘/../config/database.php’;
?>
Cara ini membantu menentukan lokasi file secara lebih konsisten meskipun script dijalankan dari direktori yang berbeda.
2. Menggunakan Include untuk File yang Wajib Ada
Menggunakan include untuk memanggil file konfigurasi atau koneksi database bisa membuat script tetap berjalan ketika file tersebut gagal dimuat. Akibatnya, error mungkin baru terlihat ketika aplikasi mencoba menjalankan proses berikutnya.
Jika file tersebut menjadi bagian penting dari aplikasi, gunakan require agar kegagalannya langsung menghentikan eksekusi.
3. Memanggil File yang Sama Tanpa Once
Pemanggilan file yang sama dari beberapa bagian aplikasi dapat menyebabkan deklarasi fungsi atau kelas berulang. Kondisi ini bisa memunculkan error yang cukup sulit dilacak jika kamu belum terbiasa memeriksa hubungan antarfile.
Gunakan require_once atau include_once ketika file berpotensi dipanggil dari beberapa tempat.
4. Memuat File dari URL Tanpa Mempertimbangkan Keamanan
PHP memiliki fitur untuk memasukkan file melalui URL, tetapi penggunaannya bergantung pada konfigurasi seperti allow_url_include. Fitur ini juga dapat menimbulkan risiko keamanan jika sumber file tidak dikendalikan dengan baik.
Untuk struktur aplikasi biasa, sebaiknya gunakan file lokal dan tentukan path dengan benar daripada mengandalkan URL untuk memuat kode PHP.
Hal Penting yang Perlu Diingat tentang Include dan Require di PHP
Memilih antara include dan require sebenarnya tidak sulit jika kamu memahami fungsi masing-masing. Include cocok untuk file tambahan yang kegagalannya tidak harus menghentikan aplikasi, sedangkan require digunakan untuk file penting yang wajib tersedia agar program dapat berjalan.
Jika file yang sama berpotensi dipanggil dari beberapa bagian aplikasi, gunakan tambahan _once untuk mencegah pemuatan berulang. Kamu bisa memakai include_once untuk komponen tambahan dan require_once untuk file inti seperti konfigurasi, fungsi, atau kelas utama.
Dengan memahami aturan tersebut, kamu bisa menyusun struktur file PHP yang lebih rapi, mengurangi risiko error, dan mempermudah proses pemeliharaan aplikasi.
