Оператор include_once() подключает и вычисляет специфицированный файл в ходе выполнения скрипта. Поведение аналогично оператору include(), но, если код файла уже был подключён, он не будет подключён вновь. Как следует из названия, он будет подключён только однократно.
include_once() должен использоваться в случаях, когда тот же самый файл может быть подключён и вычислен неоднократно в ходе выполнения скрипта, и вы хотите гарантировать, что он подключается только один раз, чтобы исключить проблемы с переопределением функций, переприсвоением переменных etc.
Примеры использования require_once() и include_once() см. в PEAR-коде, включённом в последние дистрибутивы исходного кода PHP.
Примечание: include_once() был введён в PHP 4.0.1pl2.
Предупреждение! |
---|
Windows-версия PHP в настоящее время не поддерживает доступ к удалённым/remote файлам для данной функции, даже если allow_url_fopen включена. |
См. также include(), require(), require_once(), get_required_files(), get_included_files(), readfile() и virtual().