(PHP 4, PHP 5, PHP 7, PHP 8)
Выражение include_once
включает файл и оценивает код файла как PHP-код
во время выполнения скрипта. Поведение выражения повторяет поведение выражения include,
а отличие состоит только в том, что если код из файла уже включался, PHP не включит
файл повторно, а выражение вернёт true
. Как подсказывает название выражения — файл включится
только один раз.
Выражением include_once
пользуются при риске включения
кода файла больше одного раза во время выполнения конкретного скрипта,
поэтому при таких рисках однократное включение файла помогает избегать проблем
с переопределением функций, изменением значений переменных за счёт повторного присваивания и других.
Документация к выражению include подробнее рассказывает о работе функции.