Funzione include_once
La funzione include_once include il file specificato nello script PHP corrente, ma solo se non è stato incluso in precedenza. Questo è particolarmente utile quando si lavora con file che contengono dichiarazioni di funzioni o classi, per evitare errori di ridefinizione. Alla funzione viene passato il percorso del file da includere.
Sintassi
include_once 'path/to/file.php';
Esempio
Includiamo il file config.php solo una volta:
<?php
include_once 'config.php';
include_once 'config.php'; // Questa chiamata verrà ignorata
?>
Esempio
Tentativo di includere un file inesistente:
<?php
include_once 'nonexistent.php'; // Genererà un avviso, ma non fermerà l'esecuzione dello script
echo 'Lo script continua...';
?>
Risultato dell'esecuzione del codice:
Warning: include_once(nonexistent.php): failed to open stream: No such file or directory
Lo script continua...
Esempio
Utilizzo di una variabile per specificare il percorso:
<?php
$filePath = 'lib/functions.php';
include_once $filePath;
?>
Vedi anche
-
la funzione
include,
che include un file senza controllare l'inclusione ripetuta -
la funzione
require,
che include un file arrestando lo script in caso di errore -
la funzione
require_once,
che funziona come include_once, ma arresta lo script in caso di errore
