PHP 手冊
前一頁 | 章 16. Control Structures | 下一頁

# require()

The require() statement includes and evaluates the specific file.

require() includes and evaluates a specific file. Detailed information on how this inclusion works is described in the documentation for include().

require() and include() are identical in every way except how they handle failure. include() produces a Warning while require() results in a Fatal Error. In other words, don't hesitate to use require() if you want a missing file to halt processing of the page. include() does not behave this way, the script will continue regardless. Be sure to have an appropriate include_path setting as well.

範例 16-4. Basic require() examples

`<?php require 'prepend.php'; require $somefile; require ('somefile.txt'); ?>`

See the include() documentation for more examples.

> 注: Prior to PHP 4.0.2, the following applies: require() will always attempt to read the target file, even if the line it's on never executes. The conditional statement won't affect require(). However, if the line on which the require() occurs is not executed, neither will any of the code in the target file be executed. Similarly, looping structures do not affect the behaviour of require(). Although the code contained in the target file is still subject to the loop, the require() itself happens only once.

> 注: 由於這是一個語言結構、而不是函數，所以不能以變數函數的方式來呼叫。

警告
PHP 4.3.0 之前的 Windows PHP版本不支援由此函數存取遠端檔案，即使啟動allow_url_fopen選項。

See also include(), require_once(), include_once(), eval(), file(), readfile(), virtual() and include_path.

前一頁 | 內容 | 下一頁
return | 上一層 | include()