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

phpinclude_once 'path/to/file.php';

Esempio

Includiamo il file config.php solo una volta:

php<?php
  include_once 'config.php';
  include_once 'config.php'; // Questa chiamata verrà ignorata
?>

Esempio

Tentativo di includere un file inesistente:

php<?php
  include_once 'nonexistent.php'; // Genererà un avviso, ma non fermerà l'esecuzione dello script
  echo 'Lo script continua...';
?>

Risultato dell'esecuzione del codice:

phpWarning: 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<?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