Durante lo sviluppo di un sito può capitare di includere lo stesso file più volte per errore.
Questo può causare problemi come:
❌ funzioni duplicate
⚠ errori di ridefinizione
🔄 comportamenti imprevisti
Per evitare questi problemi, PHP mette a disposizione l’istruzione
include_once.
include_onceinclude_once funziona come include,
ma con una differenza importante:
👉 il file viene incluso una sola volta, anche se il comando viene eseguito più volte.
include_once "nomefile.php"; |
<?php |
<?php |
👉 Anche se il file è incluso due volte, viene caricato solo una volta.
include_onceSe usassimo include normale:
<?php |
❌ PHP genererebbe un errore:
funzione già definita
codice duplicato
Quando PHP incontra include_once:
controlla se il file è già stato incluso
se NON lo è → lo include
se lo è già → lo ignora
include_onceÈ utile quando:
📁 si includono file con funzioni
⚙️ si includono file di configurazione
🔐 si gestiscono file importanti
🔄 si vogliono evitare duplicazioni
<?php |
👉 Il file config.php verrà eseguito una sola volta.
| Istruzione | Comportamento |
|---|---|
include |
include il file ogni volta |
include_once |
include il file una sola volta |
Usare include_once è una buona abitudine quando:
il file contiene funzioni o classi
non si è sicuri se verrà incluso più volte
Ti evita errori difficili da individuare 👍
include_once include un file una sola
volta
evita errori di duplicazione
è più sicuro rispetto a include
utile per file con funzioni o configurazioni
L’istruzione include_once è molto
utile per evitare problemi legati all’inclusione multipla dello stesso file.
È uno strumento semplice ma fondamentale per scrivere codice PHP più sicuro
e ordinato.