Функцыя 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, але спыняе скрыпт пры памылцы