include_once

Выражение include_once включает и выполняет указанный файл во время выполнения скрипта. Его поведение идентично выражению include, с той лишь разницей, что если код из файла уже один раз был включен, он не будет включен и выполнен повторно и вернёт TRUE. Как видно из имени, он включит файл только один раз.

include_once может использоваться в тех случаях, когда один и тот же файл может быть включен и выполнен более одного раза во время выполнения скрипта, в данном случае это поможет избежать проблем с переопределением функций, переменных и т.д.

Смотрите документацию по include для получения информации о том, как эта функция работает.

Замечание:

В PHP 4 функциональность _once отличалась в регистронезависимых операционных системах (таких как Windows), к примеру:

Пример #1 Пример include_once в регистронезависимых ОС для PHP 4

<?php
include_once "a.php"; // это подключит a.php
include_once "A.php"; // это подключит a.php снова! (только в PHP 4)
?>

Это поведение изменилось в PHP 5. К примеру, пути в Windows сначала нормализуются так, чтобыC:\PROGRA~1\A.php обозначало то же самое, что и C:\Program Files\a.php, и файл включается только один раз.