Учебник РНР
Назад	Глава 11. Структуры Управления	Вперёд

require()

Оператор require() подключает/include и вычисляет определённый файл.

Детально процесс подключения описан в документации для include() .

require() и include() идентичны почти во всём, за исключением того, как они обрабатывают неудачное выполнение. include() выдаёт Warning!, а require() выдаёт Fatal Error. Иначе говоря, не бойтесь использовать require(), если вам нужно, чтобы отсутствующий файл останавливал обработку страницы. include() не работает таким образом: скрипт всё равно продолжит работу. Убедитесь также в наличии соответствующей установки include_path.

Пример 11-2. Базовые примеры require()

<?php

require 'prepend.php';

require $somefile;

require ('somefile.txt');

?>

См. дополнительно примеры в документации include() .

Примечание: до версии PHP 4.0.2 применялись следующие правила: require() всегда пыталась читать файл назначения, даже если строка, в которой он указан никогда не выполнялась. Условный оператор не влиял на require(). Однако, если строка, в которой появляется require(), не выполнялась, не выполнялся и никакой код целевого файла. Аналогично циклические структуры не влияли на поведение require(). Хотя код, содержащийся в целевом файле, всё ещё является субъектом цикла, сама require() появлялась только один раз.

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

См. также include() , require_once() , include_once() , eval() , file() , readfile() , virtual() и include_path.

Назад	Оглавление	Вперёд
return	Вверх	include()