Функция require_once

Функцията require_once включва указания файл в текущия скрипт. Ако файлът вече е бил включван преди, функцията няма да го включи отново. Това е особено полезно за включване на файлове с класове или функции, където повторното включване може да причини грешки.

Синтаксис

phprequire_once 'path/to/file.php';

Пример

Нека включим файл config.php:

php<?php
  require_once 'config.php';
  echo $config['site_name'];
?>

Резултат от изпълнението на кода (ако в config.php е дефиниран масив $config):

php'My Site'

Пример

Опит за повторно включване на същия файл:

php<?php
  require_once 'functions.php';
  require_once 'functions.php'; // Това извикване ще бъде игнорирано
  echo sum(2, 3);
?>

Резултат от изпълнението на кода:

php5

Разлика от require

За разлика от require, функцията require_once проверява дали файлът вече е бил включен и не извършва повторно включване. Това предотвратява грешки при многократно включване на един и същ файл.

Вижте също

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