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