X'inhu d-differenza bejn include u require?

Question

Accepted Answer

Both `include` u `require` jimportaw (u jexekvitaw) il-kontenuti ta' file PHP ieħor fil-wieħed kurrenti. L-**unika differenza hija kif jigħandu t-telf**: `require` jikkawża fatal error jekk il-file huwa nieqes, filwaqt li `include` biss jemmetti warning u jkompli.

## Id-differenza ewlenija: failure behavior

```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
```

Uża **`require`** għal files li l-applikazzjoni **ma tista' taħdem bejniethom** (core classes, critical config, database setup) — trid li tieqaf bi mod ieħor jekk huma nieqsa. Uża **`include`** għal files fakultativi (es. sidebar template) fejn file nieqes m'għandux jagħlaqx il-paġna.

## Il-varianti _once (biex tipprevjeni double-inclusion)

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

`require_once`/`include_once` jimportaw il-file biss jekk ma kienx ġie inkluż diġà — **essenzjali** biex nevitaw "cannot redeclare function/class" errors meta file jista' jkun ineklud multipli drabi (es. definizzjoni ta' class li tiġi tratta minn bosta files).

## X'jagħmel l-inclusion fil-fatt

```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 jibdel manual includes

```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
```

Fi PHP modern, rari tuża manual `require` għal classes — **Composer's autoloader** iloqogħom on demand. Int għadek tuża `require "vendor/autoload.php"` darba biex toħloq it-tbenija inizjali.

## Għaliex xaħ

Fhim ta' `include` vs `require` hu għarifa bażika iżda importanti ta' PHP — hija kif files PHP jaqsmu kodiċi, u d-distinzjoni hija importanti għall-korrettezza.

Il-punt ewlieni hu l-failure behavior: **`require` għal files essenzjali** (sabiex l-app titqiegħed quddiem b'mod ċar jekk file kritiku huwa nieqes) u **`include` għal dawk fakultativu** (sabiex file mhux kritiku nieqes ma jagħlaqx il-paġna).

Il-għarifa tal-**varianti `_once`** hi pratikament essenzjali biex tipprevjeni l-common "cannot redeclare" errors mill-akkidenti li tinkludi definizzjoni ta' class jew function darbtejn.

Egwalment importanti hu l-għarifa tal-kuntest modern: filwaqt li dawn il-konstrutti huma fundamentali, **PHP modern jiddependi fuq Composer autoloading** (tgħabbija ta' classes on demand) minflok li jimportaw manwalment kull file, allura fil-kodiċi kurrenti inti biss fuq `require "vendor/autoload.php"` darba u ħalli autoloading jagħmilha baqija.

Il-għarifa tal-include/require mechanics (u meta kull failure mode hu xieraq) u kif modern autoloading jissostitwixxi manual includes hu għarifa ta' kuljum għaş-ħidma ma' PHP codebases qodma u ġodda.