Учебник PHP

         

require_once()

Оператор require_once() подключает/include и вычисляет специфицированный файл в процессе выполнения скрипта. Это поведение напоминает оператор require() с той только разницей, что, если код из файла уже был подключён, он не будет подключён ещё раз. См. в документации к require() информацию о работе этого оператора.

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

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

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

Предупреждение!
Windows-версия PHP в настоящее время не поддерживает доступ к удалённым файлам для этой функции, даже если включена опция allow_url_fopen.

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

Содержание раздела