Apa perbedaan antara include dan require?

Question

Accepted Answer

Baik `include` maupun `require` mengimpor (dan mengeksekusi) isi file PHP lain ke dalam file saat ini. **Satu-satunya perbedaan adalah cara mereka menangani kegagalan**: `require` menyebabkan kesalahan fatal jika file tidak ada, sementara `include` hanya mengeluarkan peringatan dan melanjutkan.

## Perbedaan kunci: perilaku kegagalan

```php
<?php
include "config.php";    // if missing → WARNING, script CONTINUES
require "database.php";  // if missing → FATAL ERROR, script STOPS
```

```text
include → file missing → emits a Warning, execution continues (file's code skipped)
require → file missing → throws a Fatal Error, execution HALTS
```

Gunakan **`require`** untuk file yang **tidak dapat dijalankan tanpa file tersebut** (class inti, config kritis, setup database) — Anda ingin aplikasi berhenti dengan tegas jika file hilang. Gunakan **`include`** untuk file opsional (misalnya template sidebar) di mana file yang hilang seharusnya tidak mengganggu halaman.

## Varian _once (cegah inklusi ganda)

```php
require_once "functions.php";   // include the file ONLY if not already included
include_once "helper.php";
```

`require_once`/`include_once` mengimpor file hanya jika belum pernah diimpor sebelumnya — **sangat penting** untuk menghindari kesalahan "cannot redeclare function/class" ketika file mungkin diinklusikan berkali-kali (misalnya definisi class yang ditarik oleh beberapa file).

## Apa yang sebenarnya dilakukan inklusi

```php
// included files share the SAME scope and can define functions, classes, variables
// config.php:
$dbHost = "localhost";
// main.php:
require "config.php";
echo $dbHost;   // "localhost" — the variable is available
```

## PHP Modern: autoloading menggantikan include manual

```php
// ❌ old style — manually requiring every class file
require_once "User.php";
require_once "Order.php";

// ✅ modern — Composer AUTOLOADING loads classes on demand automatically
require "vendor/autoload.php";   // one line; classes load when used (PSR-4)
$user = new User();               // User.php loaded automatically
```

Dalam PHP modern, Anda jarang menggunakan `require` manual untuk class — **autoloader Composer** memuat mereka saat dibutuhkan. Anda tetap menggunakan `require "vendor/autoload.php"` sekali untuk mem-bootstrap-nya.

## Mengapa ini penting

Memahami `include` vs `require` adalah pengetahuan PHP dasar namun penting — inilah cara file PHP berbagi kode, dan perbedaannya penting untuk kebenaran.

Poin utamanya adalah perilaku kegagalan: **`require` untuk file esensial** (jadi aplikasi gagal dengan cepat dan jelas jika file kritis hilang) dan **`include` untuk file opsional** (jadi file non-kritis yang hilang tidak mengganggu halaman).

Memahami **varian `_once`** secara praktis sangat penting untuk mencegah kesalahan umum "cannot redeclare" dari penginklusian definisi class atau function secara tidak sengaja dua kali.

Tidak kalah pentingnya adalah memahami konteks modern: meskipun konstruk ini fundamental, **PHP modern mengandalkan autoloading Composer** (memuat class saat dibutuhkan) daripada secara manual memerlukan setiap file, jadi dalam kode saat ini Anda sebagian besar hanya `require "vendor/autoload.php"` sekali dan biarkan autoloading menangani sisanya.

Memahami mekanik include/require (dan kapan setiap mode kegagalan sesuai) dan bagaimana autoloading modern menggantikan include manual adalah pengetahuan sehari-hari untuk bekerja dengan codebase PHP lama dan baru.