Funktionen require_once

Funktionen require_once tilføjer den angivne fil til det nuværende script. Hvis filen allerede er blevet tilføjet før, vil funktionen ikke tilføje den igen. Dette er især nyttigt til at tilføje filer med klasser eller funktioner, hvor gentagen tilføjelse kan forårsage fejl.

Syntaks

require_once 'path/to/file.php';

Eksempel

Lad os tilføje filen config.php:

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

Resultat af kodekørsel (hvis $config-arrayet er defineret i config.php):

'My Site'

Eksempel

Forsøg på gentagen tilføjelse af den samme fil:

<?php
	require_once 'functions.php';
	require_once 'functions.php'; // Dette kald vil blive ignoreret
	echo sum(2, 3);
?>

Resultat af kodekørsel:

5

Forskel fra require

I modsætning til require, kontrollerer funktionen require_once om filen allerede er blevet tilføjet, og udfører ikke en gentagen tilføjelse. Dette forhindrer fejl ved gentagen inkludering af den samme fil.

Se også

funktionen include,
som også tilføjer filer, men ikke kontrollerer for deres gentagne inkludering
funktionen include_once,
som fungerer på samme måde som require_once, men ikke forårsager en fatal fejl, hvis filen mangler