Introduzione

Un progetto PHP cresce velocemente e mantenere tutto il codice in un unico file diventa complicato. Con include() e require() possiamo suddividere il codice in moduli e importarli quando servono. La differenza principale sta nel comportamento in caso di errore: include() genera un warning e lo script continua, require() genera un errore fatale e lo script si interrompe.

Esempio con include()

In questo esempio un file esterno conterrà una semplice funzione, che verrà importata in un altro script tramite include().

Codice Esempio: uso di include()

CODE: PHP

1. <?php

2. // File: funzioni.php

3. function saluto($nome) {

4.   return "Ciao, " . $nome . "!";

5. }

6. ?>

8. <?php

9. // File principale

10. include "funzioni.php";

12. echo saluto("Mario");

13. ?>

14. <!-- Output:

15. Ciao, Mario!

16. -->

Esempio con require()

Se il file richiesto non esiste, require() blocca immediatamente l’esecuzione dello script. Questo è utile quando un file è indispensabile al funzionamento.

Codice Esempio: uso di require()

CODE: PHP

1. <?php

2. // File principale

3. require "config.php"; // se manca, errore fatale

5. echo "Script in esecuzione";

6. ?>

7. <!-- Output se config.php manca:

8. Fatal error: require(): Failed opening required 'config.php'

9. -->

Versioni _once

Esistono anche include_once() e require_once(), che evitano di includere lo stesso file più volte. Questo previene errori come la ridefinizione di funzioni o classi.

Codice Esempio: include_once()

CODE: PHP

1. <?php

2. include_once "funzioni.php";

3. include_once "funzioni.php"; // non verrà reincluso

5. echo saluto("Anna");

6. ?>

7. <!-- Output:

8. Ciao, Anna!

9. -->

Tabella riassuntiva

Considerazioni

L’uso di include e require rende il codice più modulare e leggibile. È consigliabile usare le versioni _once quando si lavora con funzioni e classi, così da prevenire conflitti dovuti a inclusioni multiple. La scelta tra include e require dipende dall’importanza del file: se è fondamentale, conviene usare require.