Funktionen include_once

Funktionen include_once tilføjer den specificerede fil til det nuværende PHP-script, men kun hvis den ikke er blevet tilføjet tidligere. Dette er især nyttigt ved arbejde med filer, der indeholder erklæringer af funktioner eller klasser, for at undgå fejl ved gentagen erklæring. Til funktionens parameter overføres stien til den fil, der skal tilføjes.

Syntaks

include_once 'path/to/file.php';

Eksempel

Lad os tilføje filen config.php kun én gang:

<?php
	include_once 'config.php';
	include_once 'config.php'; // Dette kald vil blive ignoreret
?>

Eksempel

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

<?php
	include_once 'nonexistent.php'; // Vil forårsage en advarsel, men stopper ikke scriptets udførelse
	echo 'Scriptet fortsætter...';
?>

Resultat af kodeudførelse:

Warning: include_once(nonexistent.php): failed to open stream: No such file or directory
Scriptet fortsætter...

Eksempel

Brug af variabel til at angive sti:

<?php
	$filePath = 'lib/functions.php';
	include_once $filePath;
?>

Se også

funktionen include,
som tilføjer en fil uden kontrol for gentagen inkludering
funktionen require,
som tilføjer en fil med stop af scriptet ved fejl
funktionen require_once,
som fungerer som include_once, men stopper scriptet ved fejl