Qual è la differenza tra include e require?

Question

Accepted Answer

Sia `include` che `require` importano (ed eseguono) il contenuto di un altro file PHP in quello corrente. L'**unica differenza è come gestiscono l'errore**: `require` causa un errore fatale se il file è mancante, mentre `include` emette solo un avviso e continua.

## Perché è importante

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

Usa **`require`** per i file di cui l'applicazione **non può fare a meno** (classi core, configurazione critica, setup del database) — vuoi che si arresti completamente se mancano. Usa **`include`** per file opzionali (es. un template di sidebar) dove un file mancante non dovrebbe causare il crash della pagina.

## Le varianti _once (prevenire l'inclusione doppia)

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

`require_once`/`include_once` importano il file solo se non è stato già importato — **essenziale** per evitare errori "cannot redeclare function/class" quando un file potrebbe essere incluso più volte (es. una definizione di classe richiesta da diversi file).

## Cosa fa effettivamente l'inclusione

```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 moderno: l'autoloading sostituisce gli include manuali

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

In PHP moderno, raramente usi `require` manuale per le classi — **l'autoloader di Composer** le carica on demand. Usi comunque `require "vendor/autoload.php"` una volta per avviarlo.

## Perché è importante

Comprendere `include` vs `require` è una conoscenza PHP di base ma importante — sono il modo in cui i file PHP condividono il codice, e la distinzione conta per la correttezza.

Il punto chiave è il comportamento in caso di errore: **`require` per file essenziali** (così l'app fallisce rapidamente e chiaramente se manca un file critico) e **`include` per quelli opzionali** (così un file non critico mancante non causa il crash della pagina).

Conoscere le **varianti `_once`** è praticamente essenziale per prevenire i comuni errori "cannot redeclare" dall'inclusione accidentale di una definizione di classe o funzione due volte.

Altrettanto importante è comprendere il contesto moderno: anche se questi costrutti sono fondamentali, **PHP moderno si affida all'autoloading di Composer** (caricamento delle classi on demand) piuttosto che richiedere manualmente ogni file, quindi nel codice attuale per lo più fai solo `require "vendor/autoload.php"` una volta e lasci che l'autoloading gestisca il resto.

Conoscere sia i meccanismi include/require (e quando ogni modalità di errore è appropriata) che come l'autoloading moderno sostituisce gli include manuali è una conoscenza quotidiana per lavorare con codebase PHP vecchi e nuovi.