Funkcija include_once

Funkcija include_once iekļauj norādīto failu pašreizējā PHP skriptā, bet tikai tad, ja tas nav bijis iekļauts iepriekš. Tas ir īpaši noderīgi, strādājot ar failiem, kas satur funkciju vai klašu deklarācijas, lai izvairītos no atkārtotas deklarācijas kļūdām. Funkcijas parametrā tiek padots ceļš uz iekļaujamo failu.

Sintakse

include_once 'path/to/file.php';

Piemērs

Iekļausim failu config.php tikai vienu reizi:

<?php
	include_once 'config.php';
	include_once 'config.php'; // Šis izsaukums tiks ignorēts
?>

Piemērs

Mēģinājums iekļaut neesošu failu:

<?php
	include_once 'nonexistent.php'; // Izraisīs brīdinājumu, bet neapstās skripta izpildi
	echo 'Script continues...';
?>

Koda izpildes rezultāts:

Warning: include_once(nonexistent.php): failed to open stream: No such file or directory
Script continues...

Piemērs

Mainīgā izmantošana ceļa norādīšanai:

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

Skatiet arī

funkciju include,
kas iekļauj failu bez atkārtotas iekļaušanas pārbaudes
funkciju require,
kas iekļauj failu, apturot skriptu kļūdas gadījumā
funkciju require_once,
kas darbojas kā include_once, bet aptur skriptu kļūdas gadījumā