Ֆունկցիա include_once

Ֆունկցիա include_once-ը միացնում է նշված ֆայլը ընթացիկ PHP սկրիպտին, բայց միայն այն դեպքում, եթե այն նախկինում չի միացվել: Սա հատկապես օգտակար է ֆունկցիաների կամ դասերի հայտարարումներ պարունակող ֆայլերի հետ աշխատելիս՝ կրկնակի հայտարարման սխալներից խուսափելու համար: Ֆունկցիայի պարամետրին փոխանցվում է միացվող ֆայլի ուղին:

Շարահյուսություն

include_once 'path/to/file.php';

Օրինակ

Միացնենք config.php ֆայլը միայն մեկ անգամ:

<?php
	include_once 'config.php';
	include_once 'config.php'; // Այս կանչը կանտեսվի
?>

Օրինակ

Գոյություն չունեցող ֆայլ միացնելու փորձ.

<?php
	include_once 'nonexistent.php'; // Կառաջացնի նախազգուշացում, բայց չի դադարեցնի սկրիպտի կատարումը
	echo 'Script continues...';
?>

Կոդի կատարման արդյունք.

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

Օրինակ

Փոփոխականի օգտագործումը ուղին նշելու համար.

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

Տես նաև

ֆունկցիա include,
որը միացնում է ֆայլը առանց կրկնակի ներառման ստուգման
ֆունկցիա require,
որը միացնում է ֆայլը՝ դադարեցնելով սկրիպտի կատարումը սխալի դեպքում
ֆունկցիա require_once,
որը աշխատում է ինչպես include_once-ը, բայց դադարեցնում է սկրիպտը սխալի դեպքում