Funktsioon include_once

Funktsioon include_once lisab määratud faili praegusesse PHP skripti, kuid ainult juhul, kui seda pole varem kaasatud. See on eriti kasulik failidega, mis sisaldavad funktsioonide või klasside deklaratsioone, et vältida kordusdeklaratsiooni vigu. Funktsiooni parameetrina edastatakse tee kaasatavale failile.

Süntaks

include_once 'path/to/file.php';

Näide

Kaasame faili config.php ainult üks kord:

<?php
	include_once 'config.php';
	include_once 'config.php'; // See kutse ignoreeritakse
?>

Näide

Katse kaasada olematut faili:

<?php
	include_once 'nonexistent.php'; // Tekitab hoiatus, kuid ei peata skripti täitmist
	echo 'Skript jätkub...';
?>

Koodi täitmise tulemus:

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

Näide

Muutuja kasutamine tee määramiseks:

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

Vaata ka

funktsiooni include,
mis kaasab faili ilma korduskaasamise kontrollita
funktsiooni require,
mis kaasab faili vea korral skripti peatamisega
funktsiooni require_once,
mis töötab nagu include_once, kuid peatab skripti vea korral