Funktionen require

Funktionen require tilføjer og udfører den angivne fil i det aktuelle script. I modsætning til include, forårsager den en fatal fejl og stopper udførelsen af scriptet, hvis filen mangler. Funktionen bruges ofte til at tilføje vigtige filer med funktioner, klasser eller indstillinger.

Syntaks

require 'path/to/file.php';

Eksempel

Tilføjelse af en fil med indstillinger:

<?php
	require 'config.php';
	echo $db_host; // Variabel fra config.php
?>

Hvis filen config.php eksisterer, vil dens indhold blive udført, og variablerne bliver tilgængelige.

Eksempel

Forsøg på at tilføje en ikke-eksisterende fil:

<?php
	require 'missing_file.php';
	echo 'Denne linje vil ikke blive udført';
?>

Hvis filen missing_file.php ikke eksisterer, vil scriptet afsluttes med en fejl.

Forskellen mellem require og include

Hovedforskellen er, at require forårsager en fatal fejl, hvis filen mangler, hvorimod include kun giver en advarsel.

<?php
	include 'optional_file.php'; // Scriptet fortsætter
	require 'required_file.php'; // Scriptet stopper ved fejl
?>

Se også

funktionen include,
som også tilføjer filer, men ikke stopper scriptet ved en fejl
funktionen require_once,
som garanterer, at filen kun tilføjes een gang