Funktionen include_once

Funktionen include_once inkluderar den angivna filen i det aktuella PHP-skriptet, men bara om den inte har inkluderats tidigare. Detta är särskilt användbart när man arbetar med filer som innehåller deklarationer av funktioner eller klasser för att undvika fel vid omdeklaration. Funktionens parameter är sökvägen till filen som ska inkluderas.

Syntax

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

Exempel

Låt oss inkludera filen config.php bara en gång:

<?php
	include_once 'config.php';
	include_once 'config.php'; // Detta anrop kommer att ignoreras
?>

Exempel

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

<?php
	include_once 'nonexistent.php'; // Kommer att ge en varning, men inte stoppa skriptkörningen
	echo 'Skriptet fortsätter...';
?>

Resultat av kodkörning:

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

Exempel

Använda en variabel för att ange sökväg:

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

Se även

funktionen include,
som inkluderar en fil utan kontroll för upprepad inkludering
funktionen require,
som inkluderar en fil och stoppar skriptet vid fel
funktionen require_once,
som fungerar som include_once men stoppar skriptet vid fel