Функция require

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

Синтаксис

phprequire 'path/to/file.php';

Пример

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

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

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

Пример

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

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

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

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

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

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

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

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