(PHP 4, PHP 5, PHP 7)

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