Functie include_once

De functie include_once includeert het opgegeven bestand in het huidige PHP-script, maar alleen als het niet eerder was geïncludeerd. Dit is vooral handig bij het werken met bestanden die functie- of klasse declaraties bevatten, om fouten door herhaalde declaratie te voorkomen. Aan de parameter van de functie wordt het pad naar het te includeren bestand doorgegeven.

Syntaxis

include_once 'pad/naar/bestand.php';

Voorbeeld

Laten we het bestand config.php slechts één keer includeren:

<?php
	include_once 'config.php';
	include_once 'config.php'; // Deze aanroep wordt genegeerd
?>

Voorbeeld

Poging om een niet-bestaand bestand te includeren:

<?php
	include_once 'niet_bestaand.php'; // Genereert een waarschuwing, maar stopt de uitvoering van het script niet
	echo 'Script gaat verder...';
?>

Resultaat van de code-uitvoering:

Warning: include_once(niet_bestaand.php): failed to open stream: No such file or directory
Script gaat verder...

Voorbeeld

Een variabele gebruiken om het pad op te geven:

<?php
	$bestandPad = 'lib/functions.php';
	include_once $bestandPad;
?>

Zie ook

de functie include,
die een bestand includeert zonder controle op herhaalde inclusie
de functie require,
die een bestand includeert met stop van het script bij een fout
de functie require_once,
die werkt als include_once, maar het script stopt bij een fout