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