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

require_once 'path/to/file.php';

Esempio

Includiamo il file config.php:

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

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

'My Site'

Esempio

Tentativo di inclusione ripetuta dello stesso file:

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

Risultato dell'esecuzione del codice:

5

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