Функцыя require_once

Функцыя require_once падключае паказаны файл у бягучы скрыпт. Калі файл ужо быў падключаны раней, функцыя не будзе падключаць яго зноў. Гэта асабліва карысна для падключэння файлаў з класамі альбо функцыямі, дзе паўторнае падключэнне можа выклікаць памылкі.

Сінтаксіс

require_once 'path/to/file.php';

Прыклад

Падключым файл config.php:

<?php
	require_once 'config.php';
	echo $config['site_name'];
?>

Вынік выканання кода (калі ў config.php вызначаны масіў $config):

'My Site'

Прыклад

Спроба паўторнага падключэння таго ж файла:

<?php
	require_once 'functions.php';
	require_once 'functions.php'; // Гэты выклік будзе праігнараваны
	echo sum(2, 3);
?>

Вынік выканання кода:

5

Адрозненне ад require

У адрозненне ад require, функцыя require_once правярае, ці быў файл ужо падключаны, і не выконвае паўторнае падключэнне. Гэта прадухіляе памылкі пры шматразовым уключэнні аднаго і таго ж файла.

Глядзіце таксама

функцыю include,
якая таксама падключае файлы, але не правярае іх паўторнае ўключэнне
функцыю include_once,
якая працуе аналагічна require_once, але не выклікае фатальнай памылкі пры адсутнасці файла