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