Учебник РНР
НазадГлава 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()