Функция include_once

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

Синтаксис

phpinclude_once 'path/to/file.php';

Пример

Подключим файл config.php только один раз:

php<?php
  include_once 'config.php';
  include_once 'config.php'; // Этот вызов будет проигнорирован
?>

Пример

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

php<?php
  include_once 'nonexistent.php'; // Вызовет предупреждение, но не остановит выполнение скрипта
  echo 'Script continues...';
?>

Результат выполнения кода:

phpWarning: include_once(nonexistent.php): failed to open stream: No such file or directory
Script continues...

Пример

Использование переменной для указания пути:

php<?php
  $filePath = 'lib/functions.php';
  include_once $filePath;
?>

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

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