Funktionen require

Funktionen require ansluter och kör den angivna filen i det aktuella skriptet. Till skillnad från include, orsakar den ett fatalt fel och stoppar skriptkörningen om filen saknas. Funktionen används ofta för att ansluta viktiga filer med funktioner, klasser eller inställningar.

Syntax

require 'sökväg/till/fil.php';

Exempel

Anslutning av fil med inställningar:

<?php
	require 'config.php';
	echo $db_host; // Variabel från config.php
?>

Om filen config.php finns kommer dess innehåll att köras och variablerna blir tillgängliga.

Exempel

Försök att ansluta en fil som inte finns:

<?php
	require 'saknad_fil.php';
	echo 'Denna rad kommer inte att köras';
?>

Om filen saknad_fil.php inte finns, avslutas skriptet med ett fel.

Skillnad mellan require och include

Den grundläggande skillnaden är att require orsakar ett fatalt fel om filen saknas, medan include bara ger en varning.

<?php
	include 'valfri_fil.php'; // Skriptet fortsätter att köras
	require 'obligatorisk_fil.php'; // Skriptet stoppas vid fel
?>

Se även

funktionen include,
som också ansluter filer, men inte stoppar skriptet vid fel
funktionen require_once,
som garanterar en engångsanslutning av filen