require_once()

(PHP >=4.0.1pl2, PHP 5)

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

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

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

Возвращаемое значение аналогично функции include(). Если файл уже был подключн, функция вернет TRUE.

Замечание: Be aware, that the behaviour of require_once() and include_once() may not be what you expect on a non case sensitive operating system (such as Windows).

Пример 1. require_once() регистронезависимый в Windows

require_once("a.php"); // this will include a.php
require_once("A.php"); // this will include a.php again on Windows! (PHP 4 only)

This behaviour changed in PHP 5 - the path is normalized first so that C:\PROGRA~1\A.php is realized the same as C:\Program Files\a.php and the file is required just once.

Внимание

Версии PHP для Windows до PHP 4.3.0 не поддерживают возможность использования удаленных файлов этой функцией даже в том случае, если опция allow_url_fopen включена.

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

Все функции файл
Описание на ru2.php.net
Описание на php.ru