Apakah perbezaan antara include dan require?

Question

Accepted Answer

Kedua-dua `include` dan `require` mengimport (dan melaksanakan) kandungan fail PHP lain ke dalam fail semasa. **Satu-satunya perbezaan ialah cara ia mengendalikan kegagalan**: `require` menyebabkan ralat maut (fatal error) jika fail tiada, manakala `include` hanya mengeluarkan amaran (warning) dan terus berjalan.

## Perbezaan utama: tingkah laku 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 fail yang aplikasi **tidak boleh berjalan tanpanya** (kelas teras, config kritikal, persediaan pangkalan data) — anda mahu ia berhenti sepenuhnya jika ia tiada. Gunakan **`include`** untuk fail pilihan (cth. templat sidebar) di mana fail yang tiada tidak sepatutnya menyebabkan halaman terhempas.

## Varian _once (mencegah penyertaan berganda)

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

`require_once`/`include_once` mengimport fail hanya jika ia belum diimport — **penting** untuk mengelakkan ralat "cannot redeclare function/class" apabila sesuatu fail mungkin disertakan beberapa kali (cth. takrifan kelas yang ditarik masuk oleh beberapa fail).

## Apa yang sebenarnya dilakukan oleh penyertaan

```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 moden: 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 moden, anda jarang menggunakan `require` manual untuk kelas — **autoloader Composer** memuatkannya atas permintaan. Anda masih menggunakan `require "vendor/autoload.php"` sekali untuk memulakannya.

## Mengapa ia penting

Memahami `include` vs `require` ialah pengetahuan PHP asas tetapi penting — itulah cara fail PHP berkongsi kod, dan perbezaannya penting untuk ketepatan.

Poin utamanya ialah tingkah laku kegagalan: **`require` untuk fail penting** (supaya aplikasi gagal dengan pantas dan jelas jika fail kritikal tiada) dan **`include` untuk fail pilihan** (supaya fail bukan kritikal yang tiada tidak menyebabkan halaman terhempas).

Mengetahui **varian `_once`** secara praktikal adalah penting untuk mencegah ralat biasa "cannot redeclare" akibat secara tidak sengaja menyertakan takrifan kelas atau function dua kali.

Sama pentingnya ialah memahami konteks moden: walaupun konstruk ini adalah asas, **PHP moden bergantung pada autoloading Composer** (memuatkan kelas atas permintaan) dan bukannya secara manual me-require setiap fail, jadi dalam kod semasa anda kebanyakannya hanya `require "vendor/autoload.php"` sekali dan biarkan autoloading mengendalikan selebihnya.

Mengetahui kedua-dua mekanik include/require (dan bila setiap mod kegagalan sesuai) serta cara autoloading moden mengatasi include manual ialah pengetahuan harian untuk bekerja dengan codebase PHP lama dan baharu.