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