Functie require

De functie require voegt het opgegeven bestand in en voert het uit in het huidige script. In tegenstelling tot include, veroorzaakt het een fatale fout en stopt het de uitvoering van het script als het bestand ontbreekt. De functie wordt vaak gebruikt om belangrijke bestanden met functies, klassen of instellingen in te voegen.

Syntaxis

require 'pad/naar/bestand.php';

Voorbeeld

Invoegen van een bestand met instellingen:

<?php
	require 'config.php';
	echo $db_host; // Variabele uit config.php
?>

Als het bestand config.php bestaat, wordt de inhoud ervan uitgevoerd en worden de variabelen beschikbaar.

Voorbeeld

Poging om een niet-bestaand bestand in te voegen:

<?php
	require 'ontbrekend_bestand.php';
	echo 'Deze regel wordt niet uitgevoerd';
?>

Als het bestand ontbrekend_bestand.php niet bestaat, wordt het script beëindigd met een fout.

Verschil tussen require en include

Het belangrijkste verschil is dat require een fatale fout veroorzaakt bij afwezigheid van het bestand, terwijl include alleen een waarschuwing geeft.

<?php
	include 'optioneel_bestand.php'; // Script gaat door met werken
	require 'vereist_bestand.php'; // Script stopt bij fout
?>

Zie ook

de functie include,
die ook bestanden invoegt, maar het script niet stopt bij een fout
de functie require_once,
die eenmalige invoeging van het bestand garandeert