Functie require_once

De functie require_once includeert het opgegeven bestand in het huidige script. Als het bestand al eerder was geïncludeerd, zal de functie het niet opnieuw includeren. Dit is vooral nuttig voor het includeren van bestanden met klassen of functies, waar herhaalde inclusie fouten kan veroorzaken.

Syntaxis

require_once 'pad/naar/bestand.php';

Voorbeeld

Laten we het bestand config.php includeren:

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

Resultaat van de code-uitvoering (als in config.php de array $config is gedefinieerd):

'My Site'

Voorbeeld

Poging tot herhaalde inclusie van hetzelfde bestand:

<?php
	require_once 'functions.php';
	require_once 'functions.php'; // Deze aanroep wordt genegeerd
	echo sum(2, 3);
?>

Resultaat van de code-uitvoering:

5

Verschil met require

In tegenstelling tot require, controleert de functie require_once of het bestand al was geïncludeerd en voert het geen herhaalde inclusie uit. Dit voorkomt fouten bij meervoudige inclusie van hetzelfde bestand.

Zie ook

de functie include,
die ook bestanden includeert, maar geen controle uitvoert op herhaalde inclusie
de functie include_once,
die vergelijkbaar werkt als require_once, maar geen fatale fout veroorzaakt bij afwezigheid van het bestand