include_once()

(PHP 4, PHP5)

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

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, и файл подключался лишь один раз.