Функция include_once

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

Синтаксис

include_once 'path/to/file.php';

Пример

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

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

Пример

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

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

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

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

Пример

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

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

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

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