Funksjonen require_once

Funksjonen require_once inkluderer den angitte filen i gjeldende skript. Hvis filen allerede var inkludert tidligere, vil funksjonen ikke inkludere den på nytt. Dette er spesielt nyttig for å inkludere filer med klasser eller funksjoner, hvor gjentatt inkludering kan forårsake feil.

Syntaks

require_once 'path/to/file.php';

Eksempel

La oss inkludere filen config.php:

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

Resultat av kjøring av koden (hvis $config-matrisen er definert i config.php):

'My Site'

Eksempel

Forsøk på gjentatt inkludering av samme fil:

<?php
	require_once 'functions.php';
	require_once 'functions.php'; // Dette kallet vil bli ignorert
	echo sum(2, 3);
?>

Resultat av kjøring av koden:

5

Forskjell fra require

I motsetning til require, sjekker funksjonen require_once om filen allerede var inkludert, og utfører ikke gjentatt inkludering. Dette forhindrer feil ved gjentatt inkludering av samme fil.

Se også

funksjonen include,
som også inkluderer filer, men sjekker ikke deres gjentatte inkludering
funksjonen include_once,
som fungerer på samme måte som require_once, men ikke forårsaker fatal feil ved fravær av fil