Funzione require_once

La funzione require_once include il file specificato nello script corrente. Se il file è già stato incluso in precedenza, la funzione non lo includerà nuovamente. Ciò è particolarmente utile per includere file con classi o funzioni, dove l'inclusione ripetuta potrebbe causare errori.

Sintassi

phprequire_once 'path/to/file.php';

Esempio

Includiamo il file config.php:

php<?php
  require_once 'config.php';
  echo $config['site_name'];
?>

Risultato dell'esecuzione del codice (se in config.php è definito l'array $config):

php'My Site'

Esempio

Tentativo di inclusione ripetuta dello stesso file:

php<?php
  require_once 'functions.php';
  require_once 'functions.php'; // Questa chiamata verrà ignorata
  echo sum(2, 3);
?>

Risultato dell'esecuzione del codice:

php5

Differenza con require

A differenza di require, la funzione require_once verifica se il file è già stato incluso e non esegue una nuova inclusione. Ciò previene errori durante l'inclusione multipla dello stesso file.

Vedi anche

  • la funzione include,
    che include anche file, ma non verifica la loro inclusione ripetuta
  • la funzione include_once,
    che funziona in modo simile a require_once, ma non causa un errore fatale se il file è assente