Функция 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, но не причинява фатална грешка при липса на файл