require()
require() 语句用它指定的文件代替它自己,这很像C中的预处理#include 的功能。
如果在PHP中"URL fopen wrappers"项是打开的(这是默认的配置),你可以在require()中使用URL代替本地路径。更多的信息参见Remote files和fopen()。
一个重要的提示是:当一个文件被include()或require()时,是怎样工作的,从目标文件开始分析PHP模块和HTML模块的点滴,在结束时重新摘要PHP模块。
前提是,有一些被有效地PHP开始和结束标签包含着的可执行的PHP代码在文件中。
require() 实际上不是一个PHP函数:正确的说,它是一个语言的构成部分。它的规则与函数有一些不同。如,require() 不会受包含控制结构的控制。另外,它不会返回任何值;尝试从require()调用中读取一个返回值的结果是解析错误。
不同的是include(), require() 将总是读目标文件,即使它没有可执行的行。如果你想有条件的包含一个文件,请使用include()。条件语句不会影响require()。 可是,if the line on which the require() occurs is not executed, neither will any of the code in the target file be executed.
类似的,循环控制也不会影响require()的行为。 尽管包含文件仍然受循环的控制,但是require() 只执行一次。
这意味着,你不能把require() 语句放在一个循环语句中,期待着它能在每一次循环中包含不同的文件。要这样做,请使用include() 语句。
require ('header.inc');
当一个文件被require()包含时, 包含着的代码将继承发生require() 那行的变量作用域。在调用文件行的任何可用变量在被调用文件中都将可用。如果require() 发生在正在调用文件中的函数里,这时被调用文件中的全部代码就好像已经被定义在了函数中一样。
如果require()包含的文件是经过HTTP使用fopen打开的,如果目标服务器能作为PHP代码解析目标文件,变量可以使用带有URL的有HTTPGET请求字符串的require()传递。严格的说require()一个文件和继承它的父文件的变量作用域是不同的:这个脚本实际上是运行在远程服务器上,在本地脚本中包含的是它的结果。
/* 这人例子假设someserver已经配置了.php的解析而不是.txt文件。
* 同样,'works' 意味着被包含文件中的变量$varone 和$vartwo 是可用的*/
/* Won't work; file.txt wasn't handled by someserver. */
require ("http://someserver/file.txt?varone=1&vartwo=2");
/* Won't work; looks for a file named 'file.php?varone=1&vartwo=2'
* on the local filesystem. */
require ("file.php?varone=1&vartwo=2");
/* Works. */
require ("http://someserver/file.php?varone=1&vartwo=2");
$varone = 1;
$vartwo = 2;
require ("file.txt"); /* Works. */
require ("file.php"); /* Works. */
在PHP 3中,只要语句在被require()文件的全局作用域内发生,被require() 的文件可能执行一个return 语句。不可以发生在任何块(大括号中)的内部。在PHP 4中,这人功能已被停止。如果你需要这样的功能,参见include()。
参见 include(), require_once(), include_once(), readfile(), 和 virtual().