Функция require

Функция require подключает и выполняет указанный файл в текущем скрипте. В отличие от include, при отсутствии файла вызывает фатальную ошибку и останавливает выполнение скрипта. Функция часто используется для подключения важных файлов с функциями, классами или настройками.

Синтаксис

require 'path/to/file.php';

Пример

Подключение файла с настройками:

<?php
	require 'config.php';
	echo $db_host; // Переменная из config.php
?>

Если файл config.php существует, его содержимое будет выполнено, и переменные станут доступны.

Пример

Попытка подключить несуществующий файл:

<?php
	require 'missing_file.php';
	echo 'This line will not execute';
?>

Если файл missing_file.php не существует, скрипт завершится с ошибкой.

Разница между require и include

Основное отличие - require вызывает фатальную ошибку при отсутствии файла, тогда как include только предупреждение.

<?php
	include 'optional_file.php'; // Скрипт продолжит работу
	require 'required_file.php'; // Скрипт остановится при ошибке
?>

Смотрите также

функцию include,
которая также подключает файлы, но не останавливает скрипт при ошибке
функцию require_once,
которая гарантирует однократное подключение файла