A require_once függvény

A require_once függvény a megadott fájlt húzza be az aktuális szkriptbe. Ha a fájlt korábban már behúzták, a függvény nem húzza be újra. Ez különösen hasznos osztályokat vagy függvényeket tartalmazó fájlok behúzásánál, ahol az ismételt behúzás hibákat okozhat.

Szintaxis

require_once 'path/to/file.php';

Példa

Húzzuk be a config.php fájlt:

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

A kód végrehajtásának eredménye (ha a config.php-ben definiálva van a $config tömb):

'My Site'

Példa

Próbáljuk meg ugyanannak a fájlnak az ismételt behúzását:

<?php
	require_once 'functions.php';
	require_once 'functions.php'; // Ez a hívás figyelmen kívül lesz hagyva
	echo sum(2, 3);
?>

A kód végrehajtásának eredménye:

5

Különbség a require-hez képest

A require függvénytől eltérően a require_once függvény ellenőrzi, hogy a fájl már be lett-e húzva, és nem hajtja végre az ismételt behúzást. Ez megakadályozza a hibákat ugyanannak a fájlnak a többszöri behúzása esetén.

Lásd még

a include függvényt,
amely szintén behúz fájlokat, de nem ellenőrzi azok ismételt behúzását
a include_once függvényt,
amely hasonlóan működik, mint a require_once, de nem okoz végzetes hibát, ha a fájl nem található