include_once()

Оператор include_once() подключает и вычисляет специфицированный файл в ходе выполнения скрипта. Поведение аналогично оператору include(), но, если код файла уже был подключён, он не будет подключён вновь. Как следует из названия, он будет подключён только однократно.

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

Примеры использования require_once() и include_once() см. в PEAR-коде, включённом в последние дистрибутивы исходного кода PHP.

Примечание: include_once() был введён в PHP 4.0.1pl2.

См. также include(), require(), require_once(), get_required_files(), get_included_files(), readfile() и virtual().